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The Chips are Falling 


We have just learned that Western Design Center is dramatically 
lowering the price of the 65802 microprocessors. We've been 
selling the '802 for $50.00: Effective about the time you read 
this our price will be $25.00. All the chips they produce are 
now rated to operate to at least 4 MHz, and they're now getting 
a significant yield of 6 and even 8 MHz parts. Evidently the 
volume production made possible by Apple's use of the 65816 in 
the IIgs is paying off. 


Missing ProDOS Books 


We had a scare a couple of weeks ago: Quality Software and 
Simon & Schuster had both run out of copies of Beneath Apple 
ProDOS, that excellent reference on the inner workings of 
ProDOS, so it looked for a while like we might lose a valuable 
resource. All is well, though, the folks at Quality are 
planning a new printing, so we expect to have more copies of 
the book in a month or two. We'll just hold any orders until 
that time. 


Curiously, both Addison-Wesley's ProDOS Technical Reference 
Manual and Simon & Schuster's Apple ProDOS: Advanced Features 
for Programmers have been out of stock at the publishers for a 
couple of months now. A-W tells us that a revised edition of 
Apple's manual will be published in late June. S & § has 
Advanced Features on backorder, but won't quote even a 
tentative delivery date. 


A New Pattern Search Monitor Command......Bob Sander-Cederlof 


As I mentioned in my description of the new Apple IIgs monitor 
commands (AAL Jan 87, pp.23-27), there is a new "P"“ command 
which searches through a range of memory for all occurrences of 
a pattern. Well, I tried to use that command the other day. 


First, I couldn't remember with confidence what the syntax was. 
Then I thought that it must be \pattern\adrl.adr2P. I tried 
that and it did not work. I looked it up in Fischer's “IIgs 
Technical Reference“, and verified that I did have the correct 
syntax. It still did not work, and I did need a search 
capability, so I wrote my own. More on it later. That was 
last week. I don't know why I didn't look up the command in 
another reference, but today I did. Both my memory and 
Fischer's book were wrong! 


For some esoteric reason, Apple requires that the “<" character 
appear between the pattern and the address range. My January 
article and Apple's own reference material clearly show the "“°<* 
there: \pattern\<adrl.adr2P is the correct syntax. Type it 
correctly, and it works as advertised. For example: 


\8E CO\<0/2000.5FFFP will search $2000 through S$5FFF 
in bank 0 for the two bytes $8E 
and $CO in successive locations. 

\"“Apple"\<FF/0.FFFFP will search all of bank SFF 
for the string “Apple”. (In my 
IIgs it found that string five 
times.) 


If you leave out the “<" character, nothing happens. 


The °P“” command is a powerful tool, and a welcome addition the 
Apple monitor. However, I still need some capabilities it does 
not have. For example, what if I want to find all references 
to a particular address made using any of the LDA instructions. 
I don't want to see any references using LDX, LDY, CMP, STA, 
etc. If I could tell it to only compare certain bits in some 
bytes, I could accomplish this and many other interesting 
feats. We might also like the feature of allowing a variable 
length wild card, such as in FID and FILER filenames and in the 
S-C Macro Assembler REPLACE command. Maybe I want to include 
the ability to find PC-relative references to an address. 

There is probably an endless list of possible features. 


I did write a new search program, and did include one of the 
above mentioned new features. I linked it in through the 
control-Y vector, so that I can use it from within the monitor. 
It in effect adds a new command to the monitor, with this 
Syntax “adrl.adr2Ypattern". (Where I show “Y", you have to 
type control-Y. If you are using the command from within the 
S-C Macro Assembler, you have to type control-O followed by 
control-Y.) The pattern is a sequence of hex bytes and/or 
byte-pairs. A hex byte will have to be completely matched. A 
byte-pair specifies which bits to compare by giving both a mask 
byte and a key byte. For example: 


Page 2....-Apple Assembly Line...... May, 1987...... Copyright (C) S-C SOFTWARE 


S-C Macro Assembler Version 2.0......DOS $100, ProDOS $100, both for $120 
Version 2.0 DOS Upgrade Kit for 1.0/1.1/1.2 ownerS....ccccccccccscceee 920 
ProDOS Upgrade Kit for Version 2.0 DOS ownerS......cccccccccccccssesee 930 
Source Code of S-C Macro 2.0 (DOS or ProDOS)........each, additional $100 
S-C DisAssembler (ProDOS only)...without source code $30, with source $50 
RAK-Ware DISASM (DOS only)......ewithout source code $30, with source $50 
PYOVIEW. ‘CProDOS: OnLy) 66 8.06 6:6.005:6 64 WE aoe 6 Se WAS EE WESWEAC 646 O68 OS ee O20 
Full Screen Editor for S-C Macro (with complete source code) ....e2222-949 
S-C Cross Reference Utility......without source code $20, with source $50 
S-C Word Processor (with complete source Code) ..c..cccccccccccecccccese oDU 
DP18 and DPFP, including complete source and object Ccode.....ccceceee e $590 
ES-CAPE (Extended S-C Applesoft Program Editor) .....csecce 

Including Version 2.0 With Source Code..........$50 
ES-CAPE Version 2.0 and Source Code Update (for Registered Owners)....$30 
Bag of Tricks 2 (Quality Software) .....c.cccccccsceccccccccee (949.95) $45 * 
MacASM -- Macro Assembler for MacIntosh (Mainstay)...c.e.e--($150.00) $50 
S-C Documentor (complete commented source code of Applesoft ROMsS).....$50 
Cross Assemblers for owners of S-C Macro Assembler.....$32.50 to $50 each 

(Available: 6800/1/2, 6301, 6805, 6809, 68000, Z-80, Z-8, 8048, 
8051, 8085, 1802/4/5, PDP-ll1, G1I1650/70, others) 

Beagle Bros. Applesoft Compiler (ProDOS only) ...cccccccceese ($74.95) $65 * 


& 


AAL Quarterly DiSkS....cccrcccccccsecccccees ach $15, or any four for $45 
Each disk contains the source code from three issues of AAL: 
Jan-Mar, Apr-Jun, Jul-Sep, and Oct-Dec. 
(All source code is formatted for S-C Macro Assembler. Other assemblers 
require some effort to convert file type and edit directives.) 


Diskettes (with hub ringS) ....cccccccccccecssecceese package of 25 for $15 * 
Vinyl disk pages, 6"x8.5", hold two disks eaCh....ccercccccccceee lO fOr $6 * 
Diskette Mailing Protectors (hold 1 or 2 disks).............40 cents each 


(Cardboard folders designed to fit 6"X9" Envelopes.) Or $25 per 100 * 
Envelopes for Diskette MailerS...cceccccccccccccccccccccece 6 Cents each 
$2 


65802 Microprocessor (Western Design Center) ....cccccccecceeeee (999) S30 * 
quikLoader EPROM System (SCRG) cccccccccccccccccsccesscccseecsee(Sl/9) $170 * 
PROmGRAMER CS CRG Jig evecdsc dice 1g: 6 6 Si acele see 46: 8 we thw eee Oe See wee eee Oe OU) $140 * 
Minuteman 250 Uninterruptible Power Supply... c-cccccccccceccsces (9399) $320 + 


"Apple //gs Technical Reference", FisCher..csscccecsccveceeee ($19.95) $19 
"65816/65802 Assembly Language Programming", Fischer.......-($21.95) $20 
“Programming the 65816", EyeS..ccccccccccccccccesccscsesscsee (922.99) $21 
"Apple //e Reference Manual", Apple Computer....cccccccveese ($24.95) $23 
“Apple //c Reference Manual”, Apple Computer... ..ccccccccecee ($24.95) $23 
“ProDOS Technical Reference Manual“, Apple Computer........-($29.95) $27 
“Apple ProDOS: Advanced Features for Programmers", Little..($17.95) $17 
“ProDOS Inside and Out", DomS & WeiShaaLr...cccccccccveccceee (916.95) $16 
“pOStalk Scrapbook", Weishaar & KerS@y..cccrcccccccccscccess(9l4.95) $14 
"Beneath Apple ProDOS", Worth & LeChner....ccccceccecveeccser ($19.95) $18 
"Beneath Apple DOS", Worth & LeEChner...ccccccccccccccccceses (919.95) $18 
"Inside the Apple //c%, Little. .c.cccccccccccccccccsccccveses(Sl9.95) $18 
"Inside the Apple //e", Little...ccccccccccrccccscvcccsccssee (919.95) $18 
“Understanding the Apple //e", Sather...ccccccccccccccccssee (924.95) $23 
“Understanding the Apple II", Sather... ccccccccccccvccccccsee (922.99) $21 
“Apple II+/IIe Troubleshooting & Repair Guide", Brenner.....($19.95) $18 
"Apple ][{ Circuit Description", Gayler..ccccccccscccsccceceee (922.99) $21 
“Assem. Language for Applesoft Programmers", Finley & Myers.($18.95) $18 
“Now That You Know Apple Assembly Language...", Gilder......($19.95) $18 
“Enhancing Your Apple II, vol. 1", Lancaster....cececcccceee ($15.95) $15 
“Enhancing Your Apple II, vol. 2", Lancaster....csccccsececcee ($17.95) $17 
"Assembly Cookbook for the Apple II/IIe", Lancaster.........($21.95) $20 
"Microcomputer GraphicB", MYCLB.ccecccccccscccceccccvccccece (914.95) $14 
“Assembly Lines -- the Book", Wagner.cccccccccccvecccseccsere (919.99) $18 
"“AppleVisions”, Bishop & GrOBSSDELgeLr..eccccccccccccscveccsesee (939299) $36 


*eeneeeneeneeneeeeeneeuee te &© ee t+ 


* On these items add $2.00 for the first item and 
$.75 for each additional item for US shipping. 
+ Inquire for shipping cost. 
Foreign customers inquire for postage needed. 
Texas residents please add 7.25 % sales tax to all orders. 


*** S-C SOFTWARE, P. O. BOX 280300, Dallas, TX 75228 *** 
2s (214) 324-2050 mae 
*** Master Card, VISA, Discover and American Express *** 
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0/2000.5FFFYAD FO:80 CO will find all occurrences 
of LDA $C080 through $COBF in 
bank 0, 2000-5FFF. 


FF/O.FFFFYC] DF:DO DF:DO DF:CC DF:C5 will tind all 
occurrences of “Apple® without 
regard to upper or lower case. 


In the January issue of AAL I also discussed the way to hook 
into the control-Y vector in the IIgs. It is different from 
the older Apples. Lines 1160-1230 in the following program 
install the control-Y vector in a IIgs. In an older Apple we 
would store only a 2-byte address at S$3F9 and S$3FA. This will 
still work in a IIgs, but then you would be limited to running 
in bank 0 in emulation mode. The bank S$El vector allows you to 
be called in native mode, and your code can be in any bank of 
memory. 


When you enter a control-Y command (assuming the vector has 
been installed) control will come to the SEARCH program. Lines 
1260-1290 are a nice general way to save the current mode and 
status and get into emulation mode. Lines 1600-1630 restore 
the mode and status before returning. 


Lines 1310-1320 call the GET.PATTERN subroutine and quit if 
that subroutine reports an error. GET.PATTERN scans the input 
buffer from just after the control-Y to a carriage return. It 
seemed reasonable to me to require that the entire command line 
be in the first 127 characters of the input buffer; that left 
the other half ($280-2FF) free for me to use for storing the 
converted key and mask bytes. GET.PATTERN stores the key bytes 
starting at $280, and the mask bytes starting at $2CO. It 
returns the number of bytes in the key in the X-register. Line 
1330 stores this count at WBUF, which happens to also be the 
beginning of the input buffer. 


Lines 1340-1350 copy the bank byte of the address range from 
the place the monitor keeps it ($E1013E) to the end of a 3-byte 
pointer in page zero. This seems like a good time to list all 
the places the monitor puts the addresses it parses. The 
general form of a monitor command is “a/b<c/d.ex". “a/b" is a 
target address, with “a"“ specifying the bank and "“b" specifying 
the address within the bank. "“c/d"“ is the beginning address of 
a range, with “c"“ specifying the bank and “d"“ the address 
within the bank. “e"“ is the ending address of the range, in 
the same bank with “d". "“X“ represents any monitor command 
letter. Some commands do not use all of the parsable parts, 
but you can usually get away with entering them anyway. The 
monitor subroutine called GETNUM is responsible for parsing the 
addresses. In older machines GETNUM was at SFFA7. In the IIgs 
there is still a copy of GETNUM at SFFA7, but it is not used. 
Instead a new version which starts at SF888 is used. This new 
version allows the “a/"“ and "“c/"“ parts. From my analysis, here 
is where the new GETNUM stores a, b, c, d, and e: 


$E1/013F 
$00/0042 ,43 
S$E1/013E 


a 
b- 
Cc 
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d -- $00/003C,3D and $00/0040 ,41 
e -- $00/003E,3F 


GETNUM will also leave the pointer into the input buffer which 
points to the next character after the command character in 
YSAVE, which is $00/0034. 


The IIgs also has a new subroutine at SFCCA, which gets the 
next character from the input buffer and converts it from 
lower-case to upper-case if it is a lower-case letter. 


Lines 1370-1580 perform the actual search operation. Lines 
1370-1440 compare the masked portions of the key bytes with the 
masked portion of the memory bytes starting at PNTR. If they 
all match, lines 1460-1490 call on PRADR to print the 3-byte 
address. Lines 1500-1580 increment the PNTR and test to see if 
we have come to the end of the range. [Note that a multiple- 
byte key will be tested beyond the end of the range. That is, 
the search will continue until the first key byte has been 
tested throughout the range. This means the key bytes after 
the first one will extend beyond the end of the range. I am 
pointing this out so that you will not accidentally start 
tripping softswitches in the I/O space when you have a range 
ending at SBFFF.] 


There are ample possibilities here for you to expand the 
features of this search. You could add to the GET.PATTERN a 
more flexible wild-card scheme. You could allow ASCII strings 
to be entered. You could automatically protect the I/0 
softswitch range, especially $COOO-COFF. You could save the 
current shadowing status and then turn off all shadowing during 
the search. And so on. 


I slipped in another little routine at lines 2150-2420. I am 
not calling it here, but when I did it printed out the 
currently parsed addresses. It helped me to get a better 
feeling for what happens when you enter an incomplete address 
specification. If you leave off the bank, it uses the same one 
you used before. If you leave out the range beginning, it 
begins where the previous command ended. There are a lot of 
choices here, so I find I usually just type the complete 
command to be sure. 


aaa. ®SAVE S.SEARCH.IIGS 
ye 1020 YSAVE .EQ 
E- Nake END ~EQ z, 3F ADDRESS OF END OF RANGE 
O- i ; PNTR ~EQ $40, vat, 42 START OF RANGE, CURRENT PNTR 
0200- 1080 WBUF .EQ $200 
0280- ee KBUF .EQ $280 
02C0- 1090 MBUF ~EQ $2C0 
FCCA= 1100 NXTCHR .EQ $FCCA 
FDSE- 1110 CROUT .EQ $FD8E 
FDDA- 1120 PRBYTE .EQ $FDDA 
FDED- a e6 COUT ~EQ $FDED 
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Want the best & easiest-to-use (most support) RAM card on 
the market — at the best price? Buy Checkmate Technology’s 
State-Of-The-Art MULTIRAM RGB RAM CARD” from us 
w/BATTERY BACKED-UP RAM options that save pro- 
grams like AppleWorks for years! FAST CHEAP RE- 
PLACEMENT FOR HARD DISKS, USER EXPANDABLE 
TO 17 MEGS, (100%) compatible w/all 3rd party software/ 
hardware, 65C816 option ($147), sharp 80 columns/Double 
Hi-Res, & FREE RGB! Direct substitute for Ramworks I-III" 
(we think it’s better) by Applied Engineering (also known as 
Preferred Computing) or Apple 80 col cards, has a 5 YR 
WARRANTY, 15 day money back guarantee, & FREE 
AUTOMATIC SOFTWARE UPDATES ONLY FROM US! 


MultiRam RGB expands to 1 Meg + optional BATTERY 
PROTECTABLE MultiRam Pius piggyback expandable to 
16 Meg’s. MultiRam tle expands to 768k. The software & 
manual is the best & easiest-to-use on the market — without 
exception! 


FREE APPLEWORKS EXPANDER SOFTWARE W/EVERY 
CARD — loads ALL versions of Appleworks (in 30 seconds w/ 
AW 2.0), even printer routines, runs faster, Desktop 2048k, 
23,000+ records &4,800+ word proc lines, segments Ig files 
onto multiple disks! FREE AW TIME/DAY/DATE ON-SCREEN 
w/ clock, AUTO-COPY TO RAM, PRODOS/DOS 3.3. RAM 
DISK & TEST. Optional CP/M & Pascal Ram disks ($20/ea)! 


MultiRam MuiltiRam 
RGB Card ile Card 
. 129. 
157. 
.. 187. 
. 212. 
-@# © €@ 

MultiRam 

Plus Piggyback 
256k MultiRamPlus ... 219. ... 
512k MultiRamPlus ... 269. ... 
768k MultiRamPlus ... 316. ... NEW 
1024k MultiRamPlus ... 359. ... NEW 
2-17 meg MultiRamPlus ... Call ... NEW 
Battery/AC Kit (for Plus) ... 36.... NEW 


64k MultiRam 
320k MultiRam 
576k MultiRam 
832k MultiRam 
1024k MultiRam 


NEW 
NEW 


WHY BUY FROM COIT VALLEY COMPU- 
TERS RATHER THAN SOME MAIL ORDER 
HOUSES? Only we offer a 15 day MultiRam 
complete money back satisfaction guaran- 
tee, extra software, more support, free auto- 
matic software updates, free 64k w/ each 
256k/512k/768k Ile/RGB card. We know the 
products, & stock them for fast shipping! CALL 
FOR SUPPORT, QUESTIONS, PRICES, DIS- 
COUNTS. SCHOOLS & GROUPS WELCOME. 


COIT VALLEY COMPUTERS 
(214) 234-5047 


Checkmate Technology’s MultiRam CX card easily ex- 
pands your lic to 640k and has a CX + Piggyback to add 
another 512k (1152k total)! It’s 100% compatible with all lic 
software/hardware & upgradable with a 65C816 kit ($95) — 
all at about 50% less power than Z-RAM™! Has the SAME 
FREE SOFTWARE/UPDATES & 5 YR WARRANTY AS lie 
CARDS. Buy a C-VUE fiat panel display for $287 w/ 512k 
or greater card. 


256k MULTIRAM CX 

512k MULTIRAM CX 

768k MULTIRAM CX Combo 
1024k MULTIRAM CX Combo 


256k MULTIRAM CX+ 
512k MULTIRAM CX+ 


1200 Baud lic Modem (add $20 for cable) . 147. 
Clip-on lic Rechargable Battery 

lic Flat Panel Display (w/ 512k > Mram) .... 

lic System Clock 


Cermetek 1200 internal modem Ilefi+Algs . 148. 
(+ FREE Source subscription/ VT 100 Shareware/ 
ASCll Express & ProfERM™ Setup Instructions) 


Slot 1-7 Ram Card for li+, lle, Laser 

ProAPP 20 Meg Hard Disks (+ FREE software) ... 
Apple ile Enhancement Kit 

Apple ligs 

Apple 3.5 800k Unidrive (lle/lic/ligs) 

Super Serial Compatible Card : 
RamPak 512k gs RAM card : 
Apple Compatible Drive Ile/li+ (ligs/llc + $19) ... 132. 
Clockworks Clock (Thunder/Time HO™ compat) . .. . 84. 
13” RGB Monitor w/ cables (req. RGB card) 

Heavy Duty Power Supply I1/1l+ /Ile 

lle Programmable Numeric Keypad 

System Saver Fan (i1/ll+ /ile) 

Uninterruptable Power Supply 250 watt 


AutoWorks (Best AW Macro + more) 

FontWorks (Best AW sideways/Fonts & more) .... 
Pinpoint Program 

Pinpoint Document Checker (Best Speller) 

Copy Il Pius 7.3 (Best ProDOS Utility) 

ProTERM Modem Software 

ASCil Express Modem Software 

VIP Professional (Lotus Clone. Specify Comp) ... 


Terms: Add $4-Ground or $6-Air shipping & phone # toeach U.S. 
MultiRam card order (foreign orders/FPO/APO extra). Add 3% for 
MasterCard/Visa/Am Exp (include expir date) & P.O.’s. For fast 
delivery send Cashier’s/Certified check/Money Order. C.O.D. 
(add $5) & personal checks accepted (allow 16 days). Tex res add 
7 Ya% tax. Software non-returnable. 

Ordering: PRINT Name & address, Res & Bus phone, credit card 
name/number/expir date where appropriate, qty/description/ 
price/shipping charges if known. Call for questions. 


Autoworks, Hamworks ll/Timemastec IH O/2 ram. respective trademarks of Software Touch, Apphed 
Engineering Proes subpectto change 


14055 Waterfall Way 
Dallas, Texas 75240 
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Moor 0 
000800- AQ 13 ee LDA #SEARCH Setup Control-Y vector 
000802- 8F Ail 00 E1 1180 STA qe OOK 
000806- AQ 08 1190 LDA /SEARCH 
000808- 8F A2 00 E1 1200 STA $E100A2 
0O0080C=- AX 00 1210 LD 0 
OOO80E- 8F A3 00 E1 1220 STA 100A3 
000812- 60 iea6 . RTS 
isen SE ARCH 
aoe TE. 08 1260 PHP Save mode, get into emulation mode 
000814—- 38 1ekD SEC 
000815—- FB 1280 XCE 
000816- 08 ioe . PHP 
000817- 20 54 08 1340 JSR GET.PATTERN Crack the search pattern 
OO0081A=- BO 34 1320 BCS .99 aoe noEn ang there or too long 
00081C=- 8E 00 02 1330 STX WBUF save # bytes in pattern 
00081F=- AF 3E 01 E1 1340 LDA $E101 Bank to search 
000823- 85 42 1350 STA PNTR+2 make 3-byte address 
1360 imac is pat tern-------------- 
ie nt nies 
000828= B7 40 1390 : LDA >(PNTR),Y Byte from source 
00082A- 59 80 02 1400 EOR KBUF, Byte from pattern 
00082D- 39 CO 02 1410 AND MBUF,Y Byte from mask 
000830- DO OE 1420 NE .3 -.--does not pee seep etter 
000832- CC 00 02 aiee CPY WBUF At end of pattern yet? 
000835- 90 FO Ls : ‘ Se 0e NO 
ea an a ag 
00083p- 20 DF 08 1480 JSR PRADR dabei Heaeaaic 
1500 alae 7 to next postion--------- 
OOO840- A5 40 1510 . DA PNTR Set carry if at end of range 
000842=- C5 3E 1520 CMP END 
ci. nn ee i 
000848- E6 40 1550 INC PNTR Bump comparison pointer 
OOO84A= DO 02 1560 BNE .4 
OOO84C=- E6 41 Ion INC PNTR+1 
OOO84E- 90 D5 1299 Pi BCC .1 
000850- 28 1600 .99 PLP Restore machine mode 
000851- FB 1610 XCE 
000852- 28 1620 PLP 
000853- 60 aoe ‘ RTS 
1650 GET. PATTERN 
O00854—- AX 34 1660 LDY YSAVE 
a a eh 
000859- AQ FF 1690 ; LDA #$FF Assume mask =$FF 
00085B=- 9D CO 02 1700 .2 STA MBUF,X Store a mask value 
OOO85E- AQ 00 1710 LDA #$00 Start Keybyte = $00 
googes= ab ve 0? ee 3 SBE Gate 
000865- BO 3D ho BCS ‘: --eLINE TOO LONG 
000867= 20 CA FC 1750 JSR NXTCHR GET UPPER-CASE CHAR AT WBUF,Y 
00086A- C9 AD 1760 CMP ¢" ® Is it a space? 
OOOBEE- C9 BA 1180 cmp peck. ores ROE ete 
000870- 90 11 1790 BCC .5_ < $BA, must be 0...9 
000872=- DO 05 1800 BNE .4 > $BA, must be A...F 
000874—- BD 80 02 1810 LDA KBUF,X = $BA, ":", means to put 
000877- BO E2 1820 Ss. ... ALWAYS ' value into MASK 
on a 1830 #---Try letter A...FPeq----------- 
000879=- C9 C7 1840 .4 CMP #"G* 
goapTB BG i eS BER lye v1 BAHOR 
000881- E9 1880 SBC #7 WAT eo MEO 
Nene #.--Try hex digit range---------- 
itt G2 B 13 0. CMP #"0 Is it 0...9 or A...F? 
000 = 9 1 1 10 BCC .6 oe eNO 
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000867 - 29 OF 1920 AND #$0F ar i}es» isolate digit 
000 - 1E 80 O02 1 rt ASL KBUF,X Shift previous value 
00088C- 1E 80 02 ~=: 190 ASL KBUF,X 
00088F- 1E 80 02 1950 ASL KBUF,X 
000892- 1E 80 02 ~=1960 ASL KBUF,X 
0008 95- 1D 80 02 1970 ORA KBUF,X Merge with digit 
000898- 4c 60 08 1980 JMP . 
1990 #---End of line or errores<“<<---- 
00089B- C9 8D 2000 .6 CMP #$8D 
00089D- DO 05 2010 BNE . . «ERROR 
00089F- 88 2020 DEY 
OO0OBA0- 84 34 2030 STY YSAVE 
OO0BA2- 18 2040 CLC 
O008A3- 60 2050 RTS 
2060 #---Bad char or line too long---- 
OOOBAY- 84 34 2070 .7 STY YSAVE 
OOO8A6= AQ BD 2080 LDA #$8D STORE <RETURN> IN MONITOR 
OOOBAB- 99 0102 #2090 STA WBUF+1,Y INPUT BUFFER 
OOOBAB- AQ 87 2100 LDA #387 RING THE BELL 
BaD- 20 ED FD = 2110 JSR COU 
0008B0-~ 38 2120 SEC INFORM OF ERROR 
0008B1- 60 21 0 RTS 
2150 DISPLAY. ADDRESSES 
0008B2- 08 2160 P 
0008B3- 38 2170 SEC 
OO0O8BS- FB 2180 XCE 
O008B5- 08 2190 , PHP 
OO08B6- AS 34 2210 LDA YSAVE WBUF,Y POINTS TO NEXT CHAR 
O008B8- 20 DA FD 2220 JSR PRBYTE AFTER THE CTRL-Y 
OOOB8BB- 20 8E FD 22 0 : JSR CROUT 
OOO8BE- AF 3F 01 E1 2250 LDA $£1013F 
0008C2- A2 42 2260 LDX #PNTR+2 
OOO8C4- AO BC 2270 LDY #"<™ 
OO08C6- 20 DF 08 2280 P JSR PRADR 
0008C9- AF 3E 01 E1 2300 LDA $£1013E 
OOOBCD- A2 40 2310 LDX #PNTR 
OOO8CF- AO AE 2320 LDY #",* 
OO0O08D1- 20 DF 08 23 0 : JSR PRADR 
OOOBD4- A2 3E 2350 LDX #END 
O0008D6- AO &D 2360 LDY #$8D 
OO0O08D8- 20 E7 08 23 0 : JSR PRADRO 
OO08DB- 28 2390 PLP 
O008DC- FB 2400 XCE 
OOOBDD- 28 2410 PLP 
OOO8DE- 60 2420 . RTS 
OOO8DF- 20 DA FD 2440 PRADR JSR PRBYTE PRINT BANK 
OOOBE2- AQ AF 2450 LDA #"/* 
OOO8EX- 20 ED FD 2460 JSR COUT 
2470 PRADRO 
OOO8E7- B5 01 2480 LDA 1,X PRINT HI-BYTE OF ADDRESS 
OOO8E9- 20 DA FD 2490 JSR PRBYTE 
OOOBEC- BS 00 2500 LDA 0,X PRINT LO-BYTE OF ADDRESS 
OOOBEE- 20 DA FD 2510 JSR PRBYTE 
OOO8F1- 98 2520 TYA PRINT TRAILING CHAR 
O008F2- 4c ED FD 25 0 . JMP COUT 


Another project I thought of was modifying this search prea 
so that 1t could run in an older Apple. Naturally we woul 
lose the 3-byte addresses, so the program actually becomes 
Simpler. A listing of this simpler version is shown below. 
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AZ Update... 


The fastest IIGS memory product on the market is now available with Apptied Engineering's GS-RAM and 
GS-RAM Plus memory cards. AE’s GS-RAM and GS-RAM Plus now include a new disk caching feature 


which can be used independently or with the Apple IIGS RAMdisk. (Although a RAMdisk is faster, disk 
caching is easier to use.) Caching significantly improves Apple Disk 3.5 access time. The new caching 
technique uses highly efficient and optimized machine language programs providing ultra fast, state-of-the-art 
dynamic disk caching in both ProDOS 8 and ProDOS 16 environments. This new enhancement makes 
GS-RAM and GsS-RAM Plus the fastest IIGS memory cards on the market today. Ultra fast disk caching is 
now included with all GS-RAM and GS-RAM Plus purchases. Current GS-RAM users can obtain an upgrade 
for $10. 


Applied Engineering’s DataLink modem is now ready to order with delivery in 2-3 weeks. DataLink is the 
newest and most advanced internal 1200/300 baud modem available today. DataLink incorporates the latest 
“modem on a chip” technology. Some of the components are so advanced they did not exist only one year ago. 
Because slot 2 is the normal location for a modem, Applied Engineering made an extra effort to make DataLink 
the only internal modem small enough to fit in slot 2 without interfering with the Apple IIGS’s built-in fan. 
DataLink works in the Apple IIe and II+ as well. DataLink includes powerful communications software both in 
EPROM and on disk. This state-of-the-art modem has a retail price of only $219 and is covered by a 

5 year warranty. 


New video digitizer is in the final stages of development. Unlike older techniques, Applied Engineering’s video 


digitizer incorporates its own high speed memory which solves many of the problems that the current DMA 
dependent video digitizers inherently have. Whereas other video digitizers are IIGS only, this new process will 
allow the Applied Engineering card to also work in an Apple IIe and JI+ as well as the IIGS. Video digitizers 
on the market at present require many video frames in order to digitize a picture. This results in a digitized 
image that shows tearing or distortion if there is motion when the image is digitized. Applied Engineering’s 
design is capable of digitizing a complete color or black-and-white image in a single frame, thereby eliminating 
distortion. Because the design incorporates three separate “flash analog-to-digital converters” it can actually 
digitize to a greater resolution than the Apple is capable of displaying on screen. However, the high resolution 
image can be reproduced on most printers and the video image is displayed to the maximum resolution on the 
Apple’s monitor. The product should be available in September. A price has not been set but is expected to be 
in the $250 range. 


Nonvolatile GS memory board soon to be released by Applied Engineering. The new card can piggyback to the 
GS-RAM and GS-RAM Plus cards or be used independently and uses standard dynamic RAM chips. It is 


available in | megabyte and 2 megabyte sizes. The memory on the board can be used as system memory or 
partitioned as a ROMdisk in 128K increments. If a RamCharger battery back up unit is connected, the memory 
is non-volatile. There are other techniques for creating non-volatile memory in the Apple IIGS memory 
expansion slot. One is the use of EPROMS. The engineers at Applied rejected this approach because of the 
difficulty in programming and reprogramming whenever customers wanted to update their software. The 
difficulty in programming and changing EPROMs combined with their relatively small memory capacities meant 
this approach was not acceptable. Another technique is to use SRAMs (Static RAMs) or EEPROMs 
(Electrically Erasable PROMs). These memory devices are easily programmed by the user but present the 
disadvantages of relatively small capacity and high cost. AE’s solution uses | megabyte DRAMs with a battery 
backed-up refresh circuit. This allows the currently available RamCharger battery back-up unit to be plugged 
directly into the new expander to give permanent non-volatile storage. The card can also be used without the 
RamCharger as additional memory expansion. AE’s solution has the advantages of large capacity and low cost. 


Applied Engineering’s new MS-DOS card (code named “Little Blue”) is proceeding as planned. AE expects to | 
be shipping product in October or November. Testing indicates that the product will be compatible with 
approximately 98% of IBM software; all major MS-DOS software is compatible. The card is expected to retail 
for approximately $500. 


Applied Engineering is seeking an experienced 6502 machine language programmer to develop software and 


firmware for its future line of Apple peripherals. Minimum 2 years Apple programming experience required. 
Send your resume to Applied Engineering, P.O. Box 798, Carrollton, TX 75006 Attn: Personnel. 


HAG. APPLIED ENGINEERING” 


The Apple enhancement experts. 
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1020 YSAVE ~EQ 
1030 END ~EQ 
i. 0 PNIR «EQ 


SOAVE S.SEARCH.II 


fie a 


ADDRESS OF END OF RANGE 


START OF RANGE, CURRENT PNTR 


1060 WBUF .EQ $200 
1070 KBUF .EQ $280 
1090 MBUF .EQ $2CO 
1100 CROUT .EQ $FD8E 
1110 PRBYTE .EQ $FDDA 
1130 cout ~EQ $FDED 
1140 T 
AQ OB 1150 LDA #SEARCH Setup Control-Y vector 
8D F9 03 1160 STA $3F9 
A9 0 ake LDA ARCH 
60 FA 3 1150 ars 
1310 SEARCH 
20 45 08 1220 JSR GET.PATTERN Crack the search pattern 
BO 3 Lt BCS .99 cee Bak there or too long 
8E 00 02 1240 STX WBUF save es in pattern 
waiee 1S2 5 ogre coepere. eye oners eee en ween 
c8 tehe . INY 
Bi 40 1280 LDA A LENTR) Be 4 Byte from source 
59 80 02 1290 EOR Byte from pattern 
39 CO 02 1390 AND MBUF,Y Byte from mask 
DO 14 1310 BNE --.does not pass iespectien 
CC 00 02 1320 CPY WBUF At end of pattern yet? 
90 FO 1 Be BCC .2 eo NO 
1340 @---Found a matchew-q--en-------- 
A5 41 1350 LDA PNTR+1 
ems gt aT 
20 DA FD 1360 JSR PRBYTE 
20 ED FD 1800 JSR COUT 
1410 #---Slip to next postion--------- 
AS 40 1420 . Ppa PNTR Set carry if at end of range 
C5 3E aie CMP D 
A5 41 1440 LDA PNTR+1 
E F 1450 SBC END+1 
E6 40 1460 INC PNTR Bump comparison pointer 
DO 02 Vie BNE .4 
E6 41 1480 INC PNTR+1 
90 CF 1490 .4 BCC . 
60 1210.99 RIS 
1520 #----------~~-------------------- 
aR GET. PATTERN 
AX 34 1540 LDY 
Be =| 860.1 
AQ FF ea LDA #$FF Assume mask =$FF 
9D CO 02 1580 .2 STA MBUF,X Store a mask value 
AQ 00 1590 LDA #$00 Start Keybyte = $00 
9D 80 02 1600 .3 STA KBUF,X 
CO 7F 1610 CPY #$7F 
BO 3D 1620 BCS .7 -«+eLINE TOO LONG 
20 A3 08 1D Re JSR NXTCHR GET UPPER-CASE CHAR AT WBUF,Y 
C9 AO 19 0 CMP #" * Is it a space? 
FO EA 1650 BEQ .1 o». yes, next byte 
C9 BA 1660 CMP #";*® 
90 11 1970 BCC > < $BA, must be pe 
DO 05 1S 0 BNE . > $BA, must be A...F 
BD 80 02 1690 LDA KBUF,X = $BA >", means “to put 
BO E2 1700 BCS .2 = a AYS value into MASK 
1710 #.~-Try letter | ae oF Se ee ee eT 
C9 C 1720 . CMP #"%G 
BO 2 1730 BCS .7 - «+ ERROR 
C9 Cl 1780 CMP #"A® 
90 23 1750 BCC .7 ads OR 
E9 O07 1760 SBC #7 WAN. BEM 
eevee Apple Assembly Line eoovncee May, 19 87 eoveccee ~Copyright (C) S-C 


SOFTWARE 


#---Try hex digit range---------- 
5 CMP #"0 


O874- C9 BO e Is it 0...9 or A.. ~F? 
0876- 90 14 BCC 6 oe ATW 

0878- 29 OF AND #$0F acres isolate digit 
O87A- 1E 80 02 ASL KBUF,X Shift previous value 
O87D- 1E 80 02 ASL KBUF, : 

0880- 1E 80 02 ASL KBUF,X 

0883 - 1E 80 02 ASL KBUF,X 

0 - 1D 80 02 ORA KBUF,X Merge with digit 


JMP . 
#.£--End of line or errore-We-<---- 
CMP #$8D 


O CONIA EW ND Oap cn OQUIEw m= Ow o-J 


lolelelolelolelelelelelelolosololekolololololo= 


. P 
BNE . ~- e ERROR 
DEY 
STY YSAVE 
oF a3 8 CLC 
O894- 60 RTS 
#~--Bad char or line too long---- 
0895- 84 rh ot STY YSAVE 
O0897- AQ SD LDA eee0 STORE <RETURN> IN MONITOR 
0899- 99 01 02 STA WBUF+1,Y INPUT BUFFER 
O89C- AX 87 LDA aot RING THE BELL 
O89E- 20 ED FD JSR COUT 
O8A1l=- 38 2000 SEC INFORM OF ERROR 
O8A2- 60 2010 RTS 
2020 Benn nn nn nnn nn nnn nnn een 
O8A3- BY 00 02 Sane NXTCHR LDA WBUF,Y 
O8Ab- C 2040 INY 
O8AT= C9 EI 2050 CMP #$E1 
O8A9- 90 06 2060 BC 
OSAB= C9 FB 2070 CMP #$FB 
O8AD- BO 02 2080 BC 
O8AF- 29 DF 2090 AND #$DF 
O8Bi- 60 2100 RT 
2110 8------- nn nn ne nen ee 


(a % oft. 


Basic-like macros for the S-C Macro Assembler. 
Available for the Apple I[, If +, //e, and //c. 

Uses whatever DOS your S-C Macro Assembler uses. 
Soon to be released for PRODOS. 

Source code included with every disk!!! 

Cost? A paltry $30.00!!! 

To Order — Send Check or Money Order to: 


PR Mark Manning 


Simul | 
Besaule ames c/o Baggy Games 


P. 0. Box 591894 
Houston, Texas 77259-1894 


Apple is a registered Trademark of Apple Computer Inc. 
The S-C Macro Assembler is produced by The S-C Software Corporation. 
EnterSoft is produced by Mark Manning/Simulacron |/Baggy Games 
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CESECEEEEEESEEEEEEEEEEEEEEEEEEEEEEEEEEEESE 


SPECIAL !!! EXPANDED RAM/ROM BOARD: $39.00 
Similar to our $30 RAM/ROM dev board described below. Except this board has two sockets to hold your choice 
of 2-2K RAM, 2-2K ROM or even 2-4k ROM for a total of 8K. Mix RAM and ROM too. Although Apple limits 
access to only 2K at a time, soft switches provide convenient socket selection. Hard switches contro! defaults. 


IMPROVED | 1! J[ IN A MAC (ver 2.0): $75.00 
Now includes faster graphics, UniDisk support and more! Bi-directional data transfers are a snap! This Apple II 
emulator runs DOS 3.3/PRODOS (including 6502 machine language routines) on a 512K MAC or MACPLUS. All 
Apple |! features are supported such as HI/LO-RES graphics, 40/80 column text, language card and joystick. 
Also included: clock, RAM disk, keyboard buffer, on-screen HELP, access to the desk accessories and support 
for 4 logical disk drives. Includes 2 MAC diskettes (with emulation, communications and utility software, plus 
DOS 3.3 and PRODOS system masters, including Applesoft and Integer BASIC) and 1 Apple II diskette. 


SCREEN.GEN: $35.00 
Develop HI-RES screens for the Apple Il on a Macintosh. Use MACPAINT (or any other application) on the MAC to 
create your Apple |i screen. Then use SCREEN.GEN to transfer directly from the MAC to an Apple {I (with 
SuperSerial card ) or lic. Includes Apple II diskette with transfer software plus fully commented SOURCE code. 


MIDI-MAGIC for Apple //c: $49.00 
Compatible with any MIDI equipped music keyboard, synthesizer, organ or piano. Package includes a MiDI-out 
cable (plugs directly into modem port - no modifications required!) and 6-song demo diskette. Large selection of 
digitized QRS player-piano music available for 19.00 per diskette (write for catalog). MIDI-MAGIC compatible 
with Apple Il family using Passport MID! card (or our own input/output card w/drum sync for only $99.00). 


FONT DOWNLOADER & EDITOR: $39.00 

Turn your printer into a custom typesetter. Downloaded characters remain active while printer is powered. 
Use with any Word Processor program capable of sending ESC and contro! codes to printer. Switch back and 
forth easily between standard and custom fonts. Special functions (like expanded, compressed etc.) supported. 
Includes HIRES screen editor to create custom fonts and special graphics symbols. For Apple Il, il+, //e. Specify 
printer: Apple imagewriter Apple Dot Matrix, C.ltoh 8510A (Prowriter), Epson FX 80/85, or Okidata 92/192. 
* FONT LIBRARY DISKETTE #1: $19.00 contains lots of user-contributed fonts for all printers 
supported by the Font Downloader & Editor. Specify printer with order. 


DISASM 2.2e : $30.00 ($50.00 with SOURCE Code) 
Use this intelligent disassembier to investigate the inner workings of Apple !! machine language programs. 
DISASM converts machine code into meaningful, symbolic source compatible with S-C, LISA, ToolKit and other 
assemblers. Handles data tables. displaced object code & even provides label substitution. Address-based triple 
cross reference generator included. DISASM is an invaluable machine language learning aid to both novice & 
expert alike. Don Lancaster says DISASM is “absolutely essential” in his ASSEMBLY COOKBOOK. 
The ‘PERFORMER’ CARD: $39.00 ($59.00 with SOURCE Code) 
Converts a ‘dumb’ parallel printer !/F card into a ‘smart’ one. Simple command menu. Features include 
perforation skip, auto page numbering with date & title. large HIRES graphics & text screen dumps. Specify 
printer: MX-60 with Graftrax-80, MX-100, MX-80/100 with Graftraxplus, NEC 8092A, Cltoh 8510 
(Prowriter), OkiData 82A/83A with Okigraph & OkiData 92/95. 
‘MIRROR’ ROM: $25.00 ($45.00 with SOURCE Code) 
Communications ROM plugs directly into Novation’s Apple-Cat Modem card. Basic modes: Dumb Terminal, 
Remote Console & Programmable Modem. Features include: selectable pulse or tone dialing. true dialtone 
detection, audible ring detect, ring-back, printer buffer, 80 col card & shift key mod support. 
RAM/ROM DEVELOPMENT BOARD: $30.00 
Plugs into any Apple slot. Holds one user-supplied 2Kx8 memory chip (6116 type RAM for program development 
or 2716 EPROM to keep your favorite routines on-line). Maps into $Cn00-CnFF and $C800-CFFF. 
C-PRINT For The APPLE //c: $69.00 
Connect standard parallel printers to an Apple //c serial port. Separate P/S included. Just plug in and print! 


Unless otherwise specified, all Apple I! diskettes are standard (not copy protected!) 3.3 DOS. 
Avoid a $3.00 handling charge by enclosing full payment with order. VISA/MC and COD phone orders OK. 


RAK-WARE 41 Ralph Road W. Orange NJ 07052 (201) 325-1885 
SEECEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE 
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Reading the IIgS ROMS...cccccccceesevceeeeBOD Sander-Cederlof 


A few days ago a friend and I were burning some EPROMS uSing 
the SCRG PromGramer in my IIgs. The friend said, “Why don't we 
use this card to read the IIgs ROM?* “We could put the 
PromGramer in another machine, and then put the IIgs ROMS in it 
and read them." 


Well, I don't really know why he wanted to do this. He has his 
own IIgs already anyway. Nevertheless, I can think of reasons 
to want to capture all of the ROM info on disk files. 
Disassembly, for one, using the S-C DisAssembler. Another 
reason would be to be able to compare different machines to see 
if they have the same ROM contents. But do we have to take out 
the chips to read them? 


No. The following simple commands, issued from inside the S-C 
Macro Assembler running in your IIgs, will write the entire ROM 
contents to a series of eight files. It works under either 
ProDOS or DOS 3.3: 


$00/1000<FE/0000.3FFFM 
BSAVE ROM.FE.0,A$1000,L$4000 
$00/1000<FE/4000.7FFFM 
BSAVE ROM.FE.4,A$1000,L$4000 
$00/1000<FE/8000 .BFFFM 
BSAVE ROM.FE.8,AS1000,L$4000 
$00/1000<FE/CO00.FFFFM 
BSAVE ROM.FE.C,A$1000,L$4000 
$00/1000<FF/0000.3FFFM 
BSAVE ROM.FF.0,A$1000,L$4000 
$00/1000<FF/4000.7FFFM 
BSAVE ROM.FF.4,A$1000,L$4000 
$00/1000<FF/8000 .BFFEM 
BSAVE ROM.FF.8,A$1000,L$4000 
$00/1000<FF/CO00.FFFEM 
BSAVE ROM.FF.C,AS$1000,L$4000 


I found it convenient to put those commands in a text file, 
which I named GET.ROMS. Then, whenever I want to use it, I can 
just type EXEC GET.ROMS. I took my disk down to the local 
Heathkit store around 10:45 this morning and came back with a 
copy of their ROM. 


It strikes me just now that I am being inconsistent. Sometimes 
I am saying ROM, and sometimes ROMs. There is a reason.... 


Real IIgs machines come with one system ROM chip, which is a l 
megabit ROM. It holds all 128K bytes, in only one 28-pin 
package. I presume it is uses pinouts like a 27512 EPROM, but 
selects one half or the other of the 1024K bits using what 
would normally be the programming pin on the 27512. My IIgs, 
on the other hand, is a prototype machine. It has an adapter 
plugged into the single ROM socket, which holds four 27256 
EPROM chips and one 74F139. They call it the “airplane ROMs". 
I like it, because if I want to I can easily burn a new version 
of the firmware and plug it in. Some enterprising soul might 
find a market for a board like this. 
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More About Patching Apple's ProDOS Releases 


You remember in our March issue we talked about patches to fix 
Version 1.3 of ProDOS. Apple has pulled this version off the 
market, but there are still a lot of copies floating around. 

The patches we gave in the March article should make ProDOS 1.3 
as good as any other version, but who knows? 


Anyway, we heard through the grapevine that some unofficial 
copies of version 1.4 are out, and that a brand new bug has 
surfaced in this one. It seems someone put a “LDA S$C09C,xX" 
where "LDA SCO8E,X* should be. 


I ran across a listing in the Washington Apple Pi newsletter 
(May 1987 issue, page 16) of an Applesoft program which can 
install all known necessary patches in versions 1.1.1, 1.2, 
1.3, and 1.4 of ProDOS. The program was originally written by 
Stephen Thomas to fix version 1.1.1, when the problem of the 
four STA's to the stepper motor soft-switches was discovered. 
(See Nov 86 AAL) Later Glen Bredon modified it to make the 
corresponding patches to later versions, as well as to fix the 
additional new bugs. I have further modified it, in an attempt 
to make it easier to understand. 


100 TEXT : HOME :E = 0: PRINT "PRODOS PATCH PROGRAM" 
110 IF PEEK (116 x 128 THEN E = 1: GOTO 900: REM ENUF MEM? 

120 ONERR 

130 REM oe aD ier FILE--- 

140 PRINT cin "UNLOCK PRODOS® 

150 PRINT CHR 4)"BLOAD PRODOS, TSYS, A$2000* 

200 ---SE 400 00-$60FF F FOR PATTERN--- 

210 ve = 1: FOR ACE = = B® 

220 I "peer A + 3 S ag i3 “THEN 250 

230 IF PEEK (A + 2 < > 15 THEN ae 

240 IF PEEK (A + = 192 THEN *B = 96: GOTO 290: REM VERSION 1.4 
250 IF PEEK (A +4) < > 234 THEN 2 

260 IF PEEK (A +5) < > 234 OR peeK (A + 6} < > 234 THEN 290 

270 IF PEEK (A + 7) < > 234 OR PEEK (A + 8) < > 234 THEN 290 

280 V = 2:B = 96: REM VERSION BEFORE 1.4 


290 NEXT B: E = 2: ON V GOTO 900,300,700 
300 REM erga ta VERSION BEFORE’ 1.4--- 


10 POKE A + 4,189: POKE A + 5 142: POKE A + 6,192: REM "LDA $CO8E,X* 
OO REM -=-L00k FOR OTHER PATCH o-- 
410 A = PEE + + 256 PEEK - 13 * ae +A+5 
420 E = 3: IF A < 4 # 4096 OR A > 6 1098 ape 900 
430 PEEK (A) < > 157 OR_ PEEK 1) <_ > 157 TH 0 


IF EN 50 
440 IF PEEK (A + 2) < »> mt OR PEEK” (A + 3) < 157 THEN 500 


470 us = 4.1.18: oar a 80 3° 


500 REM ~~ VERSION 1.3--- 

510 FOR I = 0 10 READ B: IF PEEK (A +1) < > B THEN TO. 900 
520 NEXT I; DATA 160,8 189,128 192" B52 232 , 136 206, 248. 234, 334, 9 
530 FOR I = 11; READ B: POKE A + £,B: NEXT I 

540 DATA 4 189, 128,192, 189,130 192, 189,132,192, 189, 134,19 

550 A = 696 + 12°@ 256 + 12° 8°16 +13: REM ADDRESS = q4uccp 

560 ror’ I = O50 3: READ B: IF PELE (A + I) < > B THEN 960 

570 NEXT I: POKE A,240: REM CHANGE "BRA" TO "BEQ* 

5 $ = GoTé 800 


0V *1. 
590 DATA 12 ay 190 ,0 
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REM =---VERSION 1.4-- 
sce A + 5,142; REM "LDA $CO9C,X" TO "LDA $CO8E,X" 


nye 


REM ---WRITE PATCHED VERSION ON DISK--- 


PRINT CHR Pad PRODOS , TSYS, A$2000" 
PRINT CHR$ (4)"LOCK PRODOS*® 
PRINT "PATCHES coe TO VERSION "V$: END 


REM ---ERROR HANDLER--- 

PRINT CHR$ (7 )SERROR! NO PATCHES WERE MADE. ® 
ON E GOTO 930,940 

PRINT "PRODOS PILE? ROT FOUND.": END 

PRINT "NOT ENOUUGH ROOM TO LOAD PRODOS.": END 
PRINT "PATCH LOCATION NOT FOUND.": END 

PRINT "PRODOS FILE MAY HAVE BEEN PATCHE 

PRINT WALREADY, OR IS NOT A COHPATIBLE VERSION .* 


WOOO OOW0 OO OO~)—I1—] 
“OWN EW ND = OWN 2 ONO 
ofololeleleo)|\ lolelelejoleleloleo) 


Lines 100-150 read the ProDOS system file into memory. Then 
Lines 200-290 search every page from $4000 through S60FF for 
either five NOPs starting at $xx04 or a “LDA $C09C,xX" 
instruction at $xx04. If neither is found, nothing is patched. 
If the five NOPs are found, we have version 1.1.1, 1.2, or 1.3. 
If the LDA is found, we have version 1.4. If it is version 
1.4, the only patch needed is to change it to “LDA SCO8E,X"“, 
which is done at lines 700-720. 


Older versions all need “LDA SCO8E,X"* poked where the five NOPs 
were, so line 310 takes care of this. Then we look at the 
address in the operand field of the instruction just prior to 
the five NOPs. This is a JSR to a little subroutine which we 
need to modify. Line 410 computes the location within the 
system file image for the twelve bytes we need to change. 


There are several possible versions of this subroutine. If it 
is a series of “STA $C08x,X" instructions, we have version 
1.1.1 or 1.2 and the STA opcodes should be changed to LDA 
opcodes. Lines 430 and 440 test for STA opcodes, and lines 
450-470 make the changes. On the other hand, if the subroutine 
is like Apple put in version 1.3 we will replace it with a 
series of four LDAs just like we made in the older versions. 
Lines 500-590 handle this, and also change an errant "BRA" 
opcode to a "BEQ"“ opcode. 


Finally, lines 800-830 write out the modified code and re-LOCK 
the file. I would be careful to check the changes made before 
doing this to every copy I own, if I were you. And bear in 
mind that Apple as a company has never authorized any of these 
changes. (They have only made them necessary, by their own 
incorrect changes.) 


While this article was waiting for the press, Apple finally 
sent out correct copies of version 1.4. I received my master 
copy June lst, and checked it against our patched version 1.3. 
They were identical except for the copyright dates and version 
numbers. The official date on this GOOD version 1.4 is April 
17, 1987. 
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RamWorks III 


Patented Performance from the Recognized Leader 


With battery backed RAM port, RGB port, increased memory capacity, full software 
compatibility and more compact design, RamWorks III ts a generation ahead 


RamWorks III is the newest 3rd 
generation RAM card for the Apple Ile. It 
incorporates all of the technology and 
improvements that years of experience 
and over a hundred thousand sales have 
given us. By selling more memory cards 
than anyone else and listening to our 
customers, we were able to design a 
memory card that has the ultimate in 
performance, quality, compatibility and 
ease of use. A design so advanced it’s 
patented. We call it RamWorks III, you'll 
call it awesome! 


The AppleWorks Amplifier. 

While RamWorks IH is recognized by 
all memory intensive programs, NO 
other expansion card comes close to 
Offering the multitude of enhancements 
to AppleWorks that RamWorks III does. 
Naturally, you’d expect RamWorks III to 
expand the available desktop, after all 
Applied Engineering was a year ahead of 
everyone else including Apple in offering 
more than 55K, and we still provide the 
largest AppleWorks desktops available. 
But a larger desktop is just part of the 
story. Look at all the AppleWorks en- 
hancements that even Apple’s own card 
does not provide and only RamWorks III 
does. With a 256K or larger RamWorks 
IIL, all of AppleWorks (including printer 
routines) will automatically load itself into 
RAM dramatically increasing speed by 
eliminating the time required to access 
the program disk drive. Switch from 
word processing to spreadsheet to data- 
base at the speed of light with no wear 
on disk drives. 


Only RamWorks eliminates Apple- 
Works’ intemal memory limits, increasing 
the maximum number of records avail- 
able from 1,350 to over 25,000. Only 
RamWorks increases the number of lines 
permitted in the word processing mode 
from 2,250 to over 15,000. And only 
RamWorks offers a built-in printer buffer, 
so you won't have to wait for your 
printer to stop before returning to Apple- 
Works. RamWorks even expands the 
clipboard. And auto segments large files 
so they can be saved on two or more 
disks. You can even have Pinpoint or 
MacroWorks and your favorite spelling 
checker in RAM for instant response. 

RamWorks, nothing comes close to 
enhancing AppleWorks so much. 


The Most Friendly, Most 
Compatible Card Available. 


Using RamWorks III couldn’t be easier 
because it's compatible with more off 
the-shelf software than any other RAM 
card Popular programs like AppleWorks, 
Pinpoint, Catalyst, MouseDesk, Howard- 
Soft, FlashCalc, Pro-Filer, Managing Your 
Money, SuperCalc 3a, and MagiCalc to 
name a few (and all hardware add on’s 
like ProFile and Sider hard disks). Ram- 
Works is even compatible with software 
written for Apple cards. But unlike other 
cards, RamWorks plugs into the He 
auxiliary slot providing our super sharp 
80 column text (U.S. Patent #4601018) in 
a completely integrated system while 
leaving expansion slots 1 through 7 
available for other peripheral cards. 

RamWorks III is compatible with all 


Apple Ile’s, enhanced, unenhanced, 
American or European versions. 


Highest Memory Expansion. 
Applied Engineering has always of 
fered the largest memory for the Ile and 
RamWorks II] continues that tradition by 
expanding to 1 full MEG on the main 
card using standard RAMs, more than 
most will ever need (1 meg is about 500 
pages of text)...but if you do ever need 
more than 1 MEG, RamWorks III has the 
widest selection of expander cards avail- 
able. Additional 512K, 2 MEG, or 16 
MEG cards just snap directly onto Ram- 
Works III by plugging into the industy’s 
only low profile (no slot 1 interference) 
fully decoded memory expansion con- 
nector. You can also choose non-volatile, 
power independent expanders allowing 
permanent storage for up to 20 years. 


It Even Corrects Mistakes. 

If you've got some other RAM card 
that’s not being recognized by your 
programs, and you want RamWorks II], 
you're in luck Because all you have to 
do is plug the memory chips from your 
current card into the expansion sockets 
on RamWorks to recapture most of your 
investment! 


The Ultimate in RGB Color. 

RGB color is an option on RamWorks 
and with good reason. Some others 
combine RGB color output with their 
memory cards, but that’s unfair for those 
who don’t need RGB and for those that 
do. Because if you don’t need RGB 
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Applied Engineering doesn’t make you 
buy it, but if you want RGB output 
youre in for a nice surprise because the 
RamWorks RGB option offers better 
color graphics plus a more readable 80 
column text (that blows away any 
composite color monitor). For only $129 
it can be added to RamWorks giving you 
a razor sharp, vivid brilliance that most 
claim is the best they have ever seen. 
Youll also appreciate the multiple text 
colors (others only have green) that 
come standard But the RamWorks RGB 
option is more than just the ultimate in 
color output because unlike others, it’s 
fully compatible with all the Apple 
standards for RGB output contol, mak- 
ing it more compatible with off the-shelf 
software. With its FCC certified design, 
you can use almost any RGB monitor 
because only the new RamWorks RGB 


IBM standard RGB outputs (cables in- 
cluded). The RGB option plugs into the 
back of RamWorks with no slot 1 inter- 


RGB Option 


ference and remember you can order 
the RGB option with your RamWorks or 
add it on at a later date. 


True 65C816 16 Bit Power. 

RamWorks II] has a built-in 65C816 
CPU port for direct connection to our 
optional 65C816 card. The only one 
capable of linearly addressing more than 
1 meg of memory for power applica- 
tions like running the Lotus 1-2-3” 
compatible program, VIP Professional. 
Our 65C816 card does not use another 
slot but replaces the 65C02 yet maintains 
full 8 bit compatibility. 


Endorsed by the Experts. 

A+ magazine said “Applied Engineer- 
ing’s RamWorks is a boon to those who 
must use large files with AppleWorks... 
like the product so much that I am 
buying one for my own system.” inCider 
magazine said “RamWorks is the most 


‘TI wanted a 
memory card for 
my Apple that was 
fast. easy to use, 
and very compat- 


ible; so | bought 
~ RamWorks.”’ 


Steve Wozniak the creator 
of Apple Computer 


\ 


powerful auxiliary slot memory card 
available for your Ile, and I rate it four 
stars..For my money, Applied Engineer- 


Option provides both Apple standard and | ing’s RamWorks is king of the hill” 


Apple experts everywhere are im- 
pressed by RamWorks's expandability, 
versatility, ease of use, and the sheer 


wy 
Bs | 
es 
£ 
* 
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4 
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‘power and speed that it adds to any Ile. 
With a RamWorks in your Apple, you'l 
make IBM PCs and ATs look like . 
slowpokes. 


Quality and Support of the 
Industry Leader 

RamWorks III is from Applied Engi- 
neering, the largest, most well supported 
manufacturer of Apple peripherals and 
the inventor of large RAM cards for the 
Apple. With our 5 year no hassle 
waranty and outstanding technical sup- 
port, you're assured of the most trouble 
free product you can buy. 


It's Got It All 
e 15 day money back guarantee 
e 5 year hassle free warranty 


e Built-in super sharp 80 column display, 
(US. Patent #4601018) 

e Expandable to 1 MEG on main card 

e Expandable to 16 meg with expander 
cards, with NO slot 1 interference 

e Can use 64K or 256K RAMs 

e Powerful linear addressing 16 bit 
coprocessor port 

e Automatic AppleWorks expansion up 

to 3017K desktop 

Accelerates AppleWorks | 

e Built-in AppleWorks printer buffer | 

| 


e The only large RAM card that’s 100% 
compatible with all Ile software 

e RamDrive™ the ultimate disk emula- 
tion software included free 

e Memory is easily partitioned allowing 
many programs in memory at once 

e Compatible, RGB option featuring ultra 
high resolution color graphics and 
multiple text colors, with cables for 
both Apple and IBM type monitors 

e Built-in self diagnostics software 

e Lowest power consumption (U.S. 
Patent #4601018) 

e Takes only one slot (auxiliary) even 

when fully expanded 

Socketed and user upgradeable 

Software industry standard 

Advanced Computer Aided Design 

Used by Apple Computer, Steve 

Wozniak and virtually all software 

companies 

Displays date and time on the Apple- 

Works screen with any PRO-DOS 

compatible clock 

Much, much more! 


RamWorks Ill with 64K 

RamWorks Ill with 256K 

RamWorks Ill with 512K 

RamWorks Ill with 1 MEG 

RamWorks Hl with 1.5 MEG 

RamWorks Ill with 2 to 16 MEG 

65C816 16 Bit Card 

RGB Option 

Optional Software: 

Pinpoint with RAM 
Enhancement Software 

VIP Professional 


RamWorks III. The industry standard 
for memory expansion of the Apple Ile. 
ORDER YOUR RamWorks III] TODAY. 
See your dealer or call (214) 241-6060, 
9am. toll p.m,, 7 days, or send check or 
money order to Applied Engineering. 

MasterCard, Visa and C.O.D. welcome. 
Texas residents add 6%% sales tax. Add 
$10.00 if outside USA 


$179 
$199 
$249 
$329 
$489 
CALL 
$159 
$129 


$79 
$219 


A Applied Engineering 
P.O. Box 798, Carroliton, TX 75006 
(214) 241-6060 


Apple Assembly Line......May, 1987......Copyright (C) S-C SOFTWARE.....Page 17 


ABC*DE=FG*HI Puzzle Solved....cceeccvceees eBOD Sander—-Cederlof 


A+ Magazine has an interesting puzzle each month, with a 
challenge to solve it with your Apple and possibly win a prize. 
The June 1987 puzzle (see page 110, “Computer Calisthenics” by 
Michael Wiesenberg) involves writing a program to find all 
possible solutions to the equation ABC*DE=FG*HI, where each 
letter represents a different digit between 1 and 9. All nine 
digits are different. 


I wrote a quick-and-dirty program in Applesoft, and then 
refined it a little for speed. Maybe speed isn't the correct 
work, because even the refined result takes nearly six minutes 
to find the eleven solutions. The first solution my program 
found was the same as the one example solution given in the A+ 
article: 158*23 = 46*79, 


Puzzles of this type can be solved, if you have enough time, by 
trying all possible combinations. A series of nested FOR 
loops, one for each digit, will produce all possible nine-digit 
arrangements. Appropriate tests can weed out all values which 
have more than one letter sharing the same digit. Inside all 
the loops you test the letter assignments against the puzzle 
equation, and print the solution if it passes. 


This will take way too long, even on a computer, so you start 
looking for ways to eliminate some combinations. The first 
thing I noticed is that I can eliminate symmetric solutions by 
forcing HI>FG. This means H>F, so I can run my FOR loop for H 
from F+tl to 9, instead of from 1 to 9. 


The smallest possible value for abc*de is 245*13=3185. This 
means F cannot be 1 or 2, because even 29*99 is too small. A 
little more examination shows that FG must be at least 34, so I 
put this into my program. 


Neither C nor E can be 5, because this would force either G or 
I to also be 5. I also notice that you cannot have a 1 on the 
right-hand side of the puzzle equation. If there were a l 
there, the largest possible FG*HI would be 91*87 = 7917. This 
is still smaller than the smallest possible left-hand side 
without al (356*24 = 8544), so it cannot work. 


Similar analysis shows that D cannot be 8 or 9. The largest 
possible FG*HI is 87*96 = 8352. If Dis 8, the smallest ABC*DE 
is 134*82 = 10988; D=9 is even worse. This also cannot work, 
so I limit my D-loop to values from 1] to 7. 


I also refined the program in the area of testing whether a 
digit has already been used by a previous letter. I maintain 
an array of flags. At the top of each loop I test the flag 
array entry to see if the digit has already been used. If not, 
I mark it used and continue. If it is already in use, I skip 
around all the inner loops to the corresponding NEXT. Here is 
the Applesoft version of my program: 
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10 Oe an : are giN(T) = I: NEXT :EPS = .0001 
198 EGR Ey ="2 TO aNd = N(GX) § IF G = 5 ORG = 0 THEN 320 

115 FG = F ® 10 + G: IF FG < 34 THEN 320 

120 N x = O: FOR HX = F + 1 TO 9:H = N(HX): IF H = O THEN 310 

130 N(HX) = O: FOR IX = 2 TO 9:I = N(IX): IF I = O ORI = 5 THEN 300 
140 HI = H ® 10 + I:P = FG ® HI: IF P < 3240 THEN 300 

150 N IX} = 0: FOR DX = 1 TO 8:D = NUK): IF D = O THEN 290 

160 N(DX) = 0: FOR EX = 1 TO 9:E = N(EX): IF E = 0 ORE = 5 280 
170 DE = D # 10 + E:Q = P / DE: IF Q < 123 OR Q < > INT (Q + EPS) THEN 280 
180 N(EX) = O:A = INT (Q / 100 + EPS): IF ae = 0 THEN 270 

190 N AY = 0:B = INT (a /10- A * 10 + EPS): IF N(B) = 0 THEN 260 
200 N(B) = 0:C = INT (Q =A # 100 —- B ® 10 + EPS): IF N(C) = O THEN 250 

= + 13 sN*:3 = = 

210 N = N +1: PRINT SPC( N < 10);N": "FG" X "HI® = "DE® X * "p 
oe akc 4 
or0 NCEX) = EX 
280 NEXT EX:N(DX) = DX 
290 NEXT DX:N(IX) = IX 

OO NEXT IX:N(HX) = HX 

10 NEXT HX:N(GX) = GX 

20 NEXT GX:N(F) = F: NEXT F 


I wanted to see how hard it would be to re-write the above 
program in assembly language, and if so how much speedier it 
would be. I am not proud that it took me over four hours to 
perfect the assembly language version. But the result is nice. 
It executes in less than seven seconds! This does not 
necessarily argue well for assembly language programming, if 
all I care about is the answers to the puzzle. But if I view 
it aS an example, and consider that the same speedup may be 
possible in much larger and much more frequently used programs, 
it does make assembly language look good. That is why programs 
like the S-C Macro Assembler and even the Applesoft firmware 
itself are written in assembly language. 


I used the same overall approach in assembly language version. 
Lines 1040-1090 initialize an array of flags I use to quickly 
check whether a digit is already in use. The flag values are 
either 0 or 1: O means a digit is in use, and 1] means it is 
available. The array is accessed by using the digit value for 
an index. I can both test a flag and change it to zero with 
one instruction: LSR FLAGS,X will shift bit 0 into carry. If 
the flag was 0, it still is and carry is clear. If the flag 
was 1] it changes to 0O and carry is set. 


Lines 1110-1520 are a equivalent of FOR statements, starting up 
a series of six nested loops to generate values for D, E, F, G, 
H, and I. Lines 1580-1880 are the equivalent to the NEXT 
statements. All the flag array handling is also included in 
these two groups of lines. I put the prior knowledge about the 
ranges of possible values for these six letters into the 
FOR-loop values, and eliminate the value 5 for letters E, G, 
and I. 


Lines 1540-1560 call subroutines to test the choices for 
letters D through I and print the resulting equation if it is a 
valid solution to the puzzle. Both of these subroutines use 
some really interesting techniques. 


The PRINT subroutine (lines 2820-3060) is controlled by a 
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format string in lines 3080-3160. This string has two kinds of 
bytes: index values between 0 and 8, and ASCII characters 
between 80 and FF. The index values int to the table of 
digits A through I. The print loop, lines 2840-2910, only 
needs four extra lines to pick up digits out of the digit.table 
and convert them to ASCII. Line 2850 branches directly to the 
JSR COUT in line 2890 if the format byte is an ASCII character 
already. Otherwise, lines 2860-2880 use the format byte as an 
index to pick up the digit and merge $BO with it to convert it 
to ASCII. This is not only neat, it is also short and fast. 
Lines 2940-3050 allow you to pause and abort the program by 
typing any key to pause, <RETURN> to abort. 


The COMPUTE.ABC subroutine (lines 1920-2710) checks the chosen 
values for D through I to see if they are a valid solution to 
the puzzle. If they are, values for A, B, and C will be chosen 
in the process of the check. Then the subroutine returns with 
carry clear to indicate a valid solution. If the solution is 
not valid, the subroutine will return with carry set. 


Lines 1930-2010 call on CALC.XX (lines 2730-2800) to calculate 
binary values for DE, FG, and HI. I could have added a test 
here to be sure that DE>33, but it did not seem to be worth the 
effort. I didn't try it, though, so I might be wrong. CALC.XX 
mutiplies the first of each pair of digits by ten, and then 
adds the second. 


Lines 2020-2160 compute WXYZ = FG*HI. The highest possible 
value for FG will be 79 and for HI will be 98. Since we are 
limiting F to the range 1 through 7, the largest possible 
combination will be 78*96 = 7488. This is $1D40. The 
calculation is a simple 8-bit by 8-bit multiplication, with a 
16-bit result. 


Lines 2170-2330 compute ABC = (FG*HI)/DE. I could have used 
two or three more nested loops to pick values for A, B, and C, 
but “it seemed like a good idea at the time® to do it this way. 
Now I think two more loops to pick A and B using the same 
techniques as for the other letters, plus a simple search 
through the flags to pick C, would be nicer. You might try it 
that way and compare the speeds of the two approaches. My 
calculation is a simple division with a 16-bit dividend, 8-bit 
divisor, 16-bit quotient, and 8-bit remainder. If the 
remainder is non-zero, then the numbers picked do not form a 
valid solution. 


Lines 2340-2460 determine the value of A by essentially 
dividing ABC by 100. ABC is a 16-bit value, so the subtraction 
loop has to do a 16-bit subtraction. The loop subtracts one 
extra time, so line 2440 corrects the remainder (which will be 
the value BC). Lines 2450-2460 check to see if the value for A 
was already used for D through I. 


Lines 2480-2580 do a similar operation to separate out the 
value of B, and by default leave the value of C in the 
A-register. Lines 2540-2570 check to see if the value for B 
was already used for D through I or for A. Finally, lines 
2590-2660 check the value for C against all the other choices. 
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Serial Pro’ 
The intelligent 
multifunction card from 
Applied Engineering. 


Serial Pro is a powerful multifunction card for the Apple Ile, 
Il+, Ics and compatible computers. Serial Pro combines a 
powerful serial port for interfacing to a printer, modem or other 
serial device, with a full function clock/calendar. Serial Pro’s serial 
port is compatible with virtually all letter quality and dot matrix 
printers, including Apple's Imagewriter and Imagewriter II, and 
can communicate with the fastest external modems at baud rates 
from 50 to 19,200. 

Set up is easy, because unlike other cards, there are no switches 
tO program serial parameters or disks to use. Serial Pro has a 
built-in setup screen that allows all parameters to be set And on- 
screen help that makes it super-easy. An on-board battery stores 
your selections for over 20 years, but you can change them at 
any time. Serial Pro is the perfect upgrade for Super Serial card 
owners looking for more performance or a built-in clock 


Serial Port Features e Fully Super Serial Card compatible but 
more versatile and easier to use e Compatible with printers 

e Compatible with modems e Prints graphics to printer (without 
software) in normal mode, 90° rotation, double size, side by side, 
and black/white inversion e Variable word length, number of 
stop bits and parity selection e Crystal controlled circuits are 
used to provide ultra accurate baud rates. 


Clock Calendar Features © ProDus, DOS and AppleWorks 
compatible. Displays ume and date on the AppleWorks screen 
e Automatically ime and date stamps AppleWorks files ¢ 20 
year auto recharging nickel-cadmium battery e Realtime inter- 
rupts ¢ Builtin on screen time and date settings (no software 
needed) © Does not use phantom slots. 

Serial Pro is perfect for Apple He, I+, Ics or compatible 
owners in need of a serial port or clock/calendar or both. But 
unlike other multifunction cards on the market Serial Pro does 
not use phantom slots, so all the slots in your computer are 
useable. 

Serial Pro comes complete with manual, cable and instructions 
for connecting to all the leading printers and modems. 

Serial Pro $159 


Order Today! See your dealer or call Applied Engineering, 9 am. 
to 11 p.m. 7 days. Or send check or money order to Applied 
Engineering MasterCard, VISA and CO.D. welcome. Texas 
residents add 5%% sales tax. Add $10.00 outside US.A 


ZAC. APPLIED ENGINEERING” 
The Apple enhancement experts 
(214) 241-6060 


P.O. Box 798, Carrollton, TX 75006 
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With the 
7-80 Plus; run 
over 5000 new 

CP/M’ programs. 


Now, get two computers 
in one, and all the 
advantages of both. 


nter the CP/M world with the new Z-80 Plus card from 

Applied Engineering, and inuoduce your Apple Ie, Ics or 
Il+ to thousands of CP/M programs. Only the Z-80 Plus comes 
standard with the new 5.1 software, the most advanced system 
ever for running CP/M programs. 

The new 5.1 boasts advanced features like built-in disk 
emulation for popular memory expansion boards, boosting both 
system speed and storage capacity. And menu-driven utilities that 
let vou get to work faster. The Z-80 Plus also lets you run older 
CP/M programs—all the way down to Version 1.6 (2.2 is the 
most popular). 

The Z-80 Plus is the only card on the market capable of 
accessing more than 64K If you have an extended 80-column 
card, all 128K is usable. And if vou have RamWorks, RamFactor, 
csRam, csRam Plus, or an Apple memory card in your Ile, Ics or 
II+, up to 1088K is available. 

Each Z-80 Plus comes with our CP/M Ram Drive software, 
enabling most memory cards to work as a high-speed Ram disk 
so CP/M software can run up to twenty) times faster. So packages 
like WordStar, dBASE IL, Turbo Pascal and most others run at 
blinding speed. 

Simply plug the Z-80 Plus into any slot in your Apple. You'll 
get the benefits of two computers in one—-all at an unbelievably 
low price (only $149!). 


e Fully compatible with ALL CP/M software —e Fully compatible 
with 5%" and 3%" disk drives as well as most hard disks includ- 
ing the Sider —e Fully compatible with Microsoft disks (no pre- 
boot required) — Specifically designed for high speed opera- 
tion e Runs WordStar, dBASE II, Turbo Pascal, and ALL other 
CP/M software with mo pre-boot —e Semi-custom LC. and low 
parts count allows Z-80 Plus to fly through CP/M programs with 
exuremely low power consumption (we use the Z-80B) e¢ Does 
EVERYTHING other Z-80 boards do, plus Z-80 interrupts 

e Five-year warranty 


To get your Z-80 Plus or for more information see your 
dealer, or call 214-241-6060 9 a.m. to 11 p.m. seven days, or send 
check or money order to Applied Engineering. MasterCard, VISA 
and C.O.D. welcome. Texas residents add 5%% sales tax. Add 
$10.00 outside US.A 


i = Applied Engineering 
P.O. Box 798, Carrollton, TX 75006 
(214) 241-6060 


CPM is a registered wademark of Digital Research 


As a final product, a program like this has little value 
(unless you win the contest!). However, it can be a great tool 
for perfecting your skill as a programmer. It is also a 
pleasant and harmless form of recreation. If you enjoy 
articles like these, let us know: we may do some more. Or, 
how about sending us one yourself? 


1000 gOAVE S. PUZZLE 


1010 @aseceone coos ese ceun ec casccesuse 
FDED- 1020 COUT .EQ $FDED 
1080 T 

0800- A2 09 1050 LDX #9 
0802- Ag 01 1060 LDA #1 STORE 1 IN EACH FLAG 
O804- 9D AC 09 1970 1 STA FLAGS ,X 
0807- CA 1080 DEX 
0808- DO FA 1090 : BNE .1 
O80A- A2 02 ~=«:'1110 LDX #2 FOR F=3 TO 8 
SAOn. BE AOU LdG ee 
0810=- 5E AC 08 1140 LSR FLAGS,X mark digit in use 
0813- EO 0 1160 CPX #3 IF F=3, START G-LOOP AT 4 
0815- FO 0 1170 BEQ LOOP.G 
HOT Te cea BE | | Pnane TS 
O81A- 5E AC 09 1200 *” LSR FLAGS,X 
081D- 90 72 1210 BCC NEXT.G  ...DIGIT ALREADY USED 
GBap- BR OS °° 1850 SPX $5 
O824~- FO 65 1380 . BEQ FIX.G  G can't be 5 
0826 - AE AO 09 1260 ae LDX F FOR H=F+1 TO 9 
O82A- 5E AC 09 1350 *” LSR FLAGS,X 
082D- 90 58 1290 BCC NEXT.H ...DIGIT ALREADY USED 
O82F- BE A2 09 1300 . STX H 
So Ag Ot 18 oop A RO TES 
0835- 5E AC 09 1380 °” LSR FLAGS,X 
0838- 90 43. ~~ ~=«:1350 BCC NEXT.£ ...DIGIT ALREADY USED 
Se AO gE 
083F- FO 3 bo . BEQ FIX.I I can't be 5 
ggar- ag oo 1800 ib 4 FOR Det TO 7 
O844- SE AC 09 1420 °” LSR FLAGS,X 
0847- 90 2A 1430 BCC NEXT.D  ...DIGIT ALREADY USED 
0849- BE 9E 09 14 0 . STX D 
auc ag 00 TED a a FOR Bo 10 9 
O84F- 5E AC 09 1490 : R FLAGS,X 
0852- 90 15 1490 BCC NEXT.E ...DIGIT ALREADY USED 
bee7e gobs vedo ek #5 
0859- FO 08 1520 : BEQ FIX.E-E can't be 5 
O85B- 20 A6 08 i280 JSR COMPUTE. ABC 
O85E- BO 0 1550 BCS FIX.E.._..- NOT AN ANSWER 
0860- 20 58 09 1560 : JSR PRINT 
0866- FE AC 09 1590 INC FLAGS,X 
0869- EO 09 1600 NEXT.E CPX # 
O86B- 90 E1 1610 . BCC LOOP.E 
Sheps AE OF OB 1698 FTED ERED ogg MTD at 
o8 - EO 0 10a0 NEXT.D CPX # . 
0875- 90 C 1600 : BCC LOOP.D . | 

10: S2ebeece occ oc ace eee solecuesecSe 
O877- AE AR 0) 1680 FIX.I LDX I NEXT I (2...9) 
O87A- FE AC 09 1690 INC FLAGS,X 
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087D- EO 09 1700 NEXT.I CPX #9 
087F- 90 B3 ay i BCC LOOP.I 
O8St=- AE A2 9 1730 FIX.H LDX H 
O884- FE AC 09 1740 INC FLAGS ,X 
0387= EO 09 1750 NEXT.H CPX # 
0889- 90 9E : - BCC LOOP.H 
O88B- AE Ai 09 1780 FIX.G LDX 
O88E- FE AC 09 130 INC FLAGS ,X 
0891=- EO 09 1800 NEXT.G CPX #9 
0 3 BO 0 1810 BCS FIX.F 
0895- 4c 19 08 spe0 ‘ JMP LOOP.G 
0898- AE AO 09 1 Ro FIX.F LDX 
08 B- FE AC 09 1 26 INC FLAGS , x 
O39E- EO 0 1860 NEXT.F CPX 
O8A0- BO 0 FY CS D 
O8A2- 4C OC 08 18 Pp P LOOP.F 
O8A5=- 60 1960 END RTS 

1920 COMPUTE. ABC 
O8A6— A2 03 th LDX #D-DIGITS 
O8AB8=- 20 4B 09 1940 JSR C.Xx 
O8AB- 8D A4 09 1950 STA DE 
O8AE= A2 05 1960 LDX #F-DIGITS 
O8BO- 20 4B 83 132? JSR CALC. 
O8B3- 8D A5 1980 STA FG 
O8B6—- A2 07 1990 LDX #H-DIGITS 
O8B8- 20 4B 09 2000 JSR CALC.XX 
O8BB- 8D A6 09 2010 STA HI 

2020 #---WXYZ = FG # 
O8BE- AO 08 2030 LDY #8 
O8CO- AQ 00 2040 LDA #0 
O8C2- 4E A5 09 2050 «1 LSR FG 
O8C5= 90 0 2060 BCC .2 
O8C7- 18 2070 CLC 
O8C8- 6D A6 09 2080 ADC HI 
O8CB- 6A 2090 .2 ROR 
O8CC- 6E A7 09 2100 ROR WXYZ 
O8CF- 88 2110 DEY 
O8D0- DO FO 2120 BNE .1 
O8D2=- 8D AB 09 2130 STA WXYZ+1 
O8D5=- 8D AA 09 2140 STA ABC+1 
O8D8~ AD AT 09 2150 LDA WXYZ 
O8DB- 8D AX 09 2160 STA ABC 

2170 S-—--ABC = WXYZ / DE 
O8DE- AO 10 2180 LDY #16 
O8EO- AQ 00 2190 LDA #0 
O8E2- 1 2200 CLC 
O8E3- 2E AX 09 2210 .3 ROL ABC 
O8E6- 2E AA 09 2220 ROL ABC+1 
OSE9= 2A 2230 ROL 
O8EA- CD A4 09 2240 CMP DE 
O8ED- 90 0 2250 BCC .4 
O8EF=- ED A4 09 2260 SBC DE 
O8F2- 88 2270 .4 DEY 
O8F3- DO EE 2280 BNE 3 
O8F5= 2E AQ 09 2290 ROL ABC 
O8F8- 2E AA 09 2300 ROL ABC+1 
O8FB- 8D AB 09 2310 STA REM 
O8FE- C9 01 2320 CMP #1 
0900- BO 47 2330 BCS .9 

2340 #---Check digits of 
0902- A2 FF 2350 LDX #-1 
0904—- AD AQ 09 2360 LDA ABC 
0907=- AC AA 09 2370 LDY ABC+1 
O90A- 38 2380 .45 SEC 
O90B- E8 2390 .5 INX 
090C- EQ 64 2400 SBC #100 
O90E- BO FB 2410 BCS . 
0910- 88 2420 DEY 
0911- 10 FT 2430 BPL .45 
0913- 69 64 2440 ADC 
0915= BC AC 09 2450 LDY 
09138- FO OF 2460 BEQ 
O91A- 8E 9B 09 2470 STX A 
091D=- A2 FF 2480 LDX #-1 
O91F- 38 2490 SEC 
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#100 
eoere »X SEE IF DIGIT ALREADY 


NEXT H (F+1...9) 


"| 
2 
i) 
va) 
e 
7% 
Q 


multiply 8-bits by 8-bits 
hee eat bit of multiplier 


bit = 
Add aultipiicand 


Shift pro 


Next aan 
oe mor 
store nicby 


~eefinal bit into quotient 


uct hi-byte 
product lo-byte 


byte of product 


If any remainder, not a valid answer 


COUNT 100'S 


CORRECT FOR OVER- aoe cea 


-«. YES, NO NEED TO Look PURTHER 
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Insist on GSRAM’” 


When You Buy Your IIcs” 


Expand the IIcs RAM and ROM with the GSRAM or GSRAM Plus 
with ROM Pak Available now with 256K to 8 MEG! 


GSRAM Plus™ 


Remaner the 16K cards for the II+ and 
the 64K cards for the Ile? At the time, that 
much memory seemed like a lot But when 
the owners of these memory cards came to 
us for more memory, many had to throw 
away’ their smaller Apple memory cards or tv 
to sell them. Most of our customers told us 
that had they known about Applied Engi- 
neering’s larger memory cards when they 
bought their Apple, they would have pur- 
chased them at the same time. 

GSRAM and GSRAM Plus are available now, 
allowing up to 8 MEG of memory expansion. 
Thats 8 times the memory capacity of 
Apple's card and just look at the benefits that 
only GSRAM and GSRAM Plus have over 
Apple's card: 

e Lower cost 

e Has 6 RAM banks (Apple's card has 4) 

e Has memory expansion port 

e Has ROM expansion port 

e No configuration blocks to set 

e No soldered in RAM chips 

e Expandable to 8 MEG 

e Expands AppleWorks intemal limits 

e Built-in Hi-Res self- diagnostic software 

e 5 vear hassle free warranty (Apple has a 90 
day warranty) 

e Made in USA 


GsRAM for More 

AppleWorks Power 

Onh: GSRAM and GSRAM Plus eliminate 
AppleWorks intemal memory limits, increas- 
ing the Maximum number of records avail: 
able from 6,000 to over 25,000 and only Gs 
RAM and GsRAM Plus increase the number 
of lines permitted in the word processing 
mode from 6,000 to over 15,000. And only 
GSRAM and GsSRAM Plus offer a builtin 
printer buffer so vou can continue using 
Appleworks while vour printer is printing, Gs 
RAM and GsRAM Plus even expand the 
number of lines in the dipboard from 255 to 
2047 and will auto segment large files so they 
can be saved on two or more disks You can 
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even have Pinpoint or Macroworks and your 
favorite spelling checker in RAM for instant 
response. GSRAM and GsSRAM Plus will even 
display the time and date right on the 
AppleWorks screen. Nothing comes dose to 
enhancing AppleWorks so much 


| 

| Turn Your Ilcs into a Giant 

| Simply plug GsRAM into the [Ics memory 

| expansion slot and you've got up to 8 mega- 

| bytes Of RAM at your fingertips—all of it 

| instantly and automatically recognized by the 

IlGs. GSRAM is compatible with all IIGs 
software, including AppleWorks, as well as 

| BASIC®, ProDos, DOS 3.3, PASCAL®, “C” and 
CP/M®. 

| Grow by Bytes or Megabytes 


We offer GSRAM in wo configurations so 
you can increase your memory 256K at a 
i time (GSRAM) or a megabyte at a time (Gs- 
| RAM Plus). Both offer full compaubility, lower 
! cost than other boards, and easy expandabil- 
| ity. And both are extremely low in power 
consumption. A fully expanded GsRAM oper- 
ates at only 375 ma, and GSRAM Plus at only 
| 270 ma (even with 6 megabvtes on board!) 
| GSRAM—for Normal 
| Memory Requirements 
| GSRAM is available with 256K, 512K, 1 
| MEG or 1.5 MEG of memory already on 
| board If you don't need the full 1.5 MEG 
| now, you can choose a GSRAM with less 
memory and expand it up to 1.5 MEG in the 
future—or upgrade to GSRAM Plus for a 
small charge. 


“In quality. 
Performance. 
compatibility. 
expandability and 
support. Applied 
Engineering's GSRAM 
and osRAM Plus are 
ntanber one” 


Steve Wozniak, the creator 
of Apple Computer 
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i them within 15 days for a full refund 


HL. APPLIED ENGINEERING” 


With an optional piggyback card, you can 
expand GSRAM even higher than 1.5 MEG! 
(Other cards are only expandable to 1 MEG.) 
GSRAM Plus—for Growing 


| by Leaps and Bounds 


GSRAM Plus is the first Apple memory card to 


_ use 1 MEG RAM chips on the main board 


Its available with 1 to 6 MEG on board. If 


_ you don’t need the whole 6 MEG now, you 
_ can buy a GSRAM Plus with less memory and 
_ easily expand it in the future. 


GSRAM Plus can be expanded up to 8 
MEG with an optional piggyback card. 
Easy Expansion 

Both GSRAM and GSRAM Plus use standard 
RAM chips that are readily available and just 
plug right in. So unlike other cards, you'll find 
expanding vour GSRAM or GSRAM Plus easy, 
convenient and very economical And with 
our optional ROM expansion module you 
can even increase the IIGs’s ROM space and 
all in just one slot 
Quality and Support of the 
Industry Leader 

Applied Engineering is the largest supplier 
of Apple peripherals in the world. We 
invented the first large RAM cards for the 
Apple. With a 5-year “no-hassle” warranty and 
outstanding technical support, youcan be | 
sure GSRAM and GSRAM Plus will deliver the 
performance you're looking for—or retum 


GSRAM with 256K 
GSRAM with 512K 


$169 
$219 
$299 
$379 


\ 
CALL 


GSRAM with 1 MEG 
GSRAM with 1.5 MEG 
GSRAM with 2-8 MEG 


GSRAM PLUS with 1 MEG $459 


| | GSRAM PLUS with 2 MEG $759 
@sRAM PLUS with 3-8 MEG CALL 


Order today! 
See your dealer or call Applied Engineering 
today, 9 am to 11 pm 7 days Or send 
check or money order to Applied Engineer- 
ing. MasterCard, VISA and CO.D. welcome. 
Texas residents add 644% sales tax. Add $10.00 
outside USA 


The Apple enbancement experts. | 
(214) 241-6060 


P.O. Box 798, Carrollton, TX 75006 


CP/M is a registered trademark of Digital Research, Inc. 
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0920- E8 A 6 INX COUNT 10'S 


0921- EQ OA 25 SBC #10 
0923- BO FB 2520 BCS . 
0925= 69 OA 2530 ADC #10 CORRECT FOR OVER-SUBTRACTION 
0927T- BC AC 09 2540 LDY FLAGS,X SEE IF DIGIT ALREADY USED 
O92A- FO 1D 2550 BEQ .9 e+e YES, NO NEED TO LOOK FURTHER 
092C- EC 9B 09 2560 CPX A 
O92F- FO 18 2570 BEQ .9 
0931- 8E 9C 09 2580 STX B 
O0934—- AA 2590 TAX 
ie BC AC 09 2600 LDY FLAGS,X SEE IF DIGIT ALREADY USED 
- FO OF 2610 BEQ .9 ~»YES, NOT A SOLUTION 
A- EC 9B 09 2620 CPX A 
093D- FO OA 2630 BEQ .9 
093F- EC 9C 09 2640 CPX B 
4 2- FO 05 2650 BEQ .9 
44- BE 9D 09 = : . STX C ~-NO, WE HAVE A SOLUTION 
a 18 2680 CLC 
0948- 60 2690 RTS 
0949- 38 2700 .9 SEC 
O94A- 60 2710 RTS 
2720 Bann nnn nnn nnn nnn enn nnn nnn ne = 
2730 CALC.XX 
O94B- BD 9B 09 2740 LDA DIGITS ,X 
O94E- OA 2750 ASL 
O94F- OA 2760 ASL 
0950- 7D 9B 09 2770 ADC DIGITS ,X 
0953- OA 2780 ASL 
0954- 7D 9C 09 2790 ADC DIGITS+1,X 
0957- 60 2800 RTS 
2810 Sunnnmmennnannernensoenoweeoooowonee 
2820 PRINT 
0958- AO 00 28 30 LDY #0 
095A- BQ 88 09 2840 «1 LDA FORMAT,Y 
095D- 30 0 2850 BMI .2 
095F- 2860 TAX 
0960- BD 9B 09 2870 LDA DIGITS ,x 
0963- 09 BO 2880 ORA #"0" 
0965- 20 ED FD 2890 .2 JSR COUT 
68- C8 2900 INY 
0969- CO 13 2910 CPY #FMT.SZ 
O96B- 90 ED oac0 ‘ BCC . 
096D- AD 00 CO 29h0 LDA $C000 
0970- 10 15 2950 BPL 
0972= 8D 10 CO 2960 STA $C010 
0975- C9 8D 2970 8D 
0977- FO OC 29 80 BEQ . 
0979- 00 CO 2990 .3 LDA $C000 
097C- 10 FB 000 BPL . 
O97E- 10 CO 3010 STA $C010 
0981- C9 8D 020 CMP #$8D 
0983- DO 02 3030 BNE . 
bo 68 O40 .4 PLA POP RETURN, SO RTS QUITS 
86- 68 050 PLA 
0987- 60 Pia RTS 
0988- 00 01 02 3080 FORMAT .HS 00.01.02 ABC 
O98B- AO D8 AO 3090 AS -" X * times 
O98E- 03 04 3100 ~HS 03.04 E 
0990- AO BD AO 3110 -AS -" = 8 
0993- 05 06 3120 ~-HS 05.06 FG 
0995- AO D8 AO 3130 AS -" X ® times 
0998- 07 08 3140 ~HS 07.08 H 
099A- 8D 3150 HS 8D 
13- Nee FMT.SZ .EQ ®-FORMAT 
3150 DIGITS 
09 9B- 3190 -BS 1 
099C- 200 B .BS 1 O9A4~ 3290 DE -BS 1 
099D- 210 C -BS 1 O9A5- 300 FG -BS 1 
099E- 220 D -BS 1 O9A6- 3310 -BS 1 
099F- 3230 E -BS 1 O9AT- 3320 WXYZ .BS 2 
09A0- 35 OF -BS 1 09A9- Bo ABC -BS 2 
O9A1- 250 G -BS 1 O9AB- 3340 REM -BS 1 
O9A2- 3260 H -BS 1 3350: Sscsece ce cceeece nas 
09A3- 3270 I -BS 1 O9AC- 3360 FLAGS .BS 10 
3280 §-------- eee enn e- 3370 #--------~------------ 
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Problem with IIgs 3.5"-Drive Firmware.....Bob Sander-Cederlof 


The firmware in the IIgs for the 3.5"-drive includes the 
so-called “Protocol Converter" interface. We discussed this 
interface a little in previous issues, especially in the May 
1986 article showing how to make DOS 3.3 work with the little 
drives. 


Last month we reported a fix you need to make to our DOS 3.3 
patches if you want it to work on a IIgs. Then last week I 
found out about another IIgs-related problem. 


The 3.5"-drive firmware in the IIgs, when you call it through 
the Protocol Converter interface, stomps on four pagezero 
locations which are used by other programs. Locations $57, 58, 
59, and 5A all are used without any concern for how they might 
already be in use. The firmware makes a great effort to save 
and restore all sorts of other locations, but these it just 
walks over, kicking sand like the big bully at the beach. 


We first noticed the problem when using the S-C Macro Assembler 
with our 3.5” version of DOS 3.3. After any commands using the 
3.5" drive, such as LOAD, SAVE, CATALOG, or whatever, the line 
number INCREMENT would be cleared to zero. That value is kept 
by S-C Macro in $5A, which the 3.5" firmware zeroes. This 
means after any disk operation you need to type INC 10, or INC 
with whatever increment you want to use. Luckily, the other 
three bytes are not actively in use during a disk operation. 


In Applesoft these locations hold temporary string descriptors. 
I think they are only used while executing One statement, so it 
is possibly all right to share them with the firmware. 


Apple probably is not going to do anything about this problem, 
because supposedly only NEW software would be coming in through 
the Protocol Converter interface. The ProDOS interface does 
not have any problem, because it either does not use those 
locations or it saves-restores them properly. 


I think we probably are going to have to be the ones to change. 
Either we have to add code to our Unidisk DOS 3.3 to save ana 
restore those four bytes, or we have to change the patch to use 
the ProDOS interface for reading and writing blocks rather than 
the Protocol Converter. The trouble with the latter approach 
is that the ProDOS interface requires the use of locations 
$42-$47, and four of these are already in use by higher levels 
of DOS 3.3! It is hard to win at this game. Either way we end 
up needing to save and restore four bytes. 


Until we decide one way or the other, we need to at least come 
up with a fix for our Unidisk DOS 3.3 that will allow you to 
use it with the S-C Macro Assembler without losing yur 
INCrement every time you turn around. Of the four clobbered 
bytes, only $5A is critical to the assembler. I found a way to 
save enough bytes in Bill's code to slip this in. It had to be 
“slipped” in, so that the references to the DOS patches made in 
Bill's boot program do not have to be changed. 
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Lines 1970-2020 in Bill's Unidisk driver were: 


1970 sta block 

1980 ldy #5 

1990 lda (iob.ptr),y 
2000 lsr 

2010 ora block 

2020 sta block 


Replace those lines with the following, which take the same 
space: 


1970 asl 

1980 ldy #5 

1990 ora (iob.ptr) ,y 
2000 ror 

2010 sta block 

2012 lda $5a 


2014 pha 
2016 nop 
2020 nop 


This performs the same function as the original code, but adds 
the feature of saving location $5A on the stack. At the exit 
we need to restore S$5A from the stack, so look at lines 
3100-3110 of Bill's program. They were: 


3100 sta (iob.ptr),y 
3110 rts 


Change them to: 
3100 jmp bobs.patch 
Then insert new code as follows: 


3202 bobs.patch 
3203 sta (iob.ptr) ,y 


3204 pla 
3205 sta $5a 
3206 rts 


I entered the above patches by using the monitor peeking and 
poking commands, and they do seem to work correctly. Here are 
the commands I used: 


0O0O/BF8E:91 48 68 85 5A 60 
00/BF82:4C 8E BF 
00/BED6:0A AO 05 11 48 6A 8D 89 BF AS 5A 48 EA EA 


You could add these commands to the EXEC file which loads the 
IIgs version of the S-C Macro Assembler. 


In going over Bill's code while preparing this article, I also 
noticed that his line 1860, "STA LAST.BLOCK", should be “STA 
LAST .BLOCK+1". You probably should make this change regardless 
of what kind of computer you are uSing. 
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be up and running in less than 1 second! 


Very Compatible 

All the leading software is already com- 
patible with RamFactor. Programs like Apple- 
Works, Pinpoint, BPI, Managing Your Money, 
Dollars and Sense, SuperCalc 3A, PFS, Mouse- 
Write, MouseDesk, MouseCalc, Sensible 
Speller, Applewriter Ile, Business Works, 


i ReportWorks, Catalyst 3.0 and more. And 


RamFactor is fully ProDos, DOS 3.3, Pascal 1.3 
and CP/M compatible. In fact, no other slot 
1-7 memory card is more compatible with 
commercial software. 


AppleWorks Power 

There are other slot 1-7 cards that give 
AppleWorks a larger desktop, but thars the 
end of their story. But RamFactor is the only 
slot 1-7 card that increases AppleWorks 
intemal memory limits, increasing the maxi- 
mum number of records in the database and 
lines permitted in the word processor, and 
RamFactor is the only standard slot card that 
will automatically load all of AppleWorks into 
RAM dramatically increasing speed and 
eliminating the time required to access the 
program disk, it will even display the time 
and date on the AppleWorks screen with 
any ProDos clock RamFactor will automati- 
cally segment large files so they can be 
saved on 5%", 3%", and hard disks. All this 
performance is available on the Apple II+, 


Nw anyone with an Apple II+, Franklin, Laser 128, Apple He or IIcs preferring to use 
slots 1 through 7 can now enjoy the speed and performance that they’ve been waiting for. 
With RamFactor, you'll be able to instanty add another 256K, 512K, or a full 1 MEG on 
the main board and an expansion connector can address an additional 16 MEG of 
memory for possible future expansion. Since virtually all software is automatically 
compatible with RamFactor, you'll immediately be able to load programs into RamFactor 
for instantaneous access to information. You'll also be able to store more data for larger 
word processing documents, bigger data bases, and expanded spreadsheets. And with the 
battery back-up Option, you can switch on your Apple and vour favorite software will 


Ile, Franklin, or Laser 128 when used with an 


80 column display. RamFactor, no other 
standard slot card comes dose to enhancing 
AppleWorks so much. 


The “Instant On” Apple. 

With the RamCharger 
battery backup op- 
uon, RamFactor 
will retain pro- 
grams and data 
during power 
failures or even 

when you tum your computer off And 
because RamFactor plugs into slots 1-7, its 
the only memory card that can cold boot 
an Apple without using slow floppy or hard 
disks. An available “Y” cable allows one 
RamCharger to power two RamFactors. 


. Ey 2 z 


Powerful Program Switcher 

With RamFactor, you can organize 
memory into multiple work areas and switch 
between them. Each work area can contain 
different programs and even different operat- 
ing systems. Now you can switch from one 
program to another or even switch from 
AppleWorks to DOS 3.3 to CP/M to Pascal to 
ProDos in under a second And with our 
battery back-up option, you can have 
permanent storage for up to 20 years. 


Ram Factor 


Boot any I+, le, or Ilcs and be up and running your 
Javorite software in less than 1 second 


Features: 

e 256K to 1 MEG on main board Expansion 
connector for possible further expansion to 
16 MEG. 

e Fully Apple I] Memory Expansion 
compatible 

e Compatible with Apple Ile, H+, IIcs, 
Franklin and Laser 128 

e Battery back-up option allows vou to tum 
on your Apple and run your favorite 
programs in less than 1 second! 

e Automatically recognized by ProDos, DOS 
3.3, Pascal, and standard CP/M 


 e Builtin RamDrive™ software (a tue RAM 


disk not disk caching) 
e Systems are directly boowble from Ram- 
Factor if desired 


_e Builtin self diagnostic software 


e Automatic expansion with AppleWorks 1.3 
or 2.0 


_e Allows Apple I+ and Ie to run your 


AppleWorks without buying any 
additional software 

e Accelerates AppleWorks 

e Displays ime and date on the AppleWorks 
screen with any ProDos clock 

e Fits anv I/O slot except slot 3 

e Fully socketed and user upgradeable 

e Much, much more 


RamFactor with 256K 
RamFactor with 512K 
RamFactor with 1 MEG 


$239 
$279 
$359 
CALL 
$179 

$24 


RamFactor with 2-16 MEG 
RamCharger backup option 
“Y¥” cable 


{Allows one RamCharger to power two RamFactors.) 


Order RamFactor today .. . with 15 day 
money back guarantee and our “no hassle” 
five year warranty. See your dealer or call 
(214) 241-6060, 9 am. to 11 pm, 7 days, or 
send check or money order to Applied 
Engineering, MasterCard, Visa and C.O.D. 
welcome. Texas residents add 6% sales tax 
Add $10.00 if outside USA 


I. Applied Engineering” 


The Apple enhancement experts 
(214) 241-6060 


P.O. Box 798, Carrollton, TX 75006 
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IIgs Tool Set Version NumberS..ccceccececece eBOD Sander-Cederlof 


According to Apple's published specifications, all IIgs tool 
sets are supposed to contain a function which returns a version 
number. Furthermore I think we can expect that the version 
numbers will be updated whenever any changes are made to the 
tools. Hopefully, programs which use the tools can first check 
to see if the version in ROM or RAM is up-to-date enough to be 
used. 


It would be nice to be able to run a little program which would 
list the current version number for all installed tools. I 
wrote such a program, and it is shown below. 


Since I am running under control of the S-C Macro Assembler 
Version 2.0, my program will receive control from the emulation 
mode. Therefore lines 1110-1130 get me into full native mode 
so that I can call tools. When I am finished, lines 1280-1290 
put me back in emulation mode and return to the S-C Macro 
control. 


The body of the program is a loop to call each of the tool sets 
from 1 to $20. Function number 4 of each tool is supposed to 
return the version number. This function requires one two-byte 
parameter space on the stack, in which to return the version 
number. Lines 1170-1190 set up the call and call a tool, and 
lines 1200-1220 store any error code returned as well as the 
version number. If the tool is not installed we will get an 
error code of 0002. 


To display the results I wrote a little subroutine which runs 
in emulation mode. This is convenient, since all of our 
friendly monitor ROM I/O routines left over from the old days 
are only callable from emulation mode. There are probably some 
nice tools in the IIgs to take the place of COUT, PRBYTE, 
CROUT, and others, but these old friends are certainly easier 
to use and to remember. 


My display routine prints an encoded string. Any bytes in the 
string which have the high bit on are printed as ASCII 
characters by calling COUT at SFDED. Any byte in value between 
$01 and $7F is treated as an index into page zero. The 
contents of the indexed location are printed out in hexadecimal 
by calling PRBYTE at SFDDA. A $00 byte in the string marks the 
end. 


PRINT.FORMAT is called with the Y-register pointing just before 
the first character to be printed. This arrangement lets me 
break after printing the version number, and then just call 
PRINT.FORMAT again to print the error number when there is one. 


Note at line 1370 I get the status byte I pushed at line 1320 
by uSing a stack-relative LDA. Then I used LSR to shift bit 0, 
which was the carry bit, into C. Why didn't I use PLP followed 
by a PHP here? It would save one byte and have the same net 
effect, right? 


Well I tried that, and it didn't work. The reason is that the 
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PLP-PHP is inside my emulation mode subroutine. In emulation 
mode it is impossible to keep the status bits in the m- and 
x-bit positions in a zero state. Regardless of what they were 
when I pushed them at line 1320, after a PLP-PHP operation in 
emulation mode they will both be l's. This undid the calling 
program, which believed it was still in full 16-bit mode. Zap! 
Pow! Wham! Beep! So I used the safer approach. 


If you want to adapt the display subroutine for other purposes 
and use it in an older Apple that doesn't have a 65816 in it, 

you can go back to the PLP-PHP method. You will also need to 

change the BRA opcodes at lines 1540 and 1560 to JMP's. 


hare goAVE S.TOQOL.VERSIONS 
1383 é -OP 65816 
01- 0 TOOL ~EQ $01,02 
03- 1050 VERSION .EQ 303,04 
1070 & 
1590 : Program to display Version Numbers of All Tools 
1100 DVN 
50080- FB 1120 XCE 
000802- C2 30 A tnS REP $320 "Full" Native mode 
OOO8OH=- AQ 01 O4 1140 LDA ##$0401 For TOOL = $0401 to $0420 
000807—- 85 01 a STA TOQGL 
000809—- F4 00 00 yt | PEA 0 Make room for version number 
OOO80C= A6 01 1180 LDX TOOL Tool # and function 
OOO80E- 22 00 00 E1 1190 JSR $£10000 Go get it! 
000812= 85 05 1200 STA ERROR Any error code 
000814—- 68 1210 PLA Tool version # 
000815= 85 03 1220 STA VERSION 
000817= 20 25 08 iho JSR DISPLAY. RESULTS 
00081A=- E6 01 1240 INC TOOL Next tool set 
= eee ONLY EO 80 a2Preece 
00081C= A5 01 1250 LDA TOOL l f 
Seeeer $$ eb 1g UE ARMA whore vet 
= e eee lO ere e 
000823- FB 1260 XCE --. that is far enough 
000824- 60 1eRp RTS 
1340 DISPLAY. RESULTS 
000825- 08 1320 PHP 
000826- 38 | Be SEC 
pOCESA= Ao Br 1360 EDY #1 
00082A- 20 39 08 1360 JSR PRINT.FORMAT 
0O0082D- A3 01 1310 LDA 1,8 GET STATUS BYTE 
O0082F=- HA 1380 LSR TO SEE IF THERE WAS AN ERROR 
000830- 90 03 1320 BCC .1 -e-NO ERROR 
000832- 20 39 08 1400 JSR PRINT. FORMAT 
000835- 18 1410 .1 CLC 
0008 36=- FB 1420 XCE 
000837- 28 1130 PLP 
000838- 60 i : RTS 
1u26 PRINT. FORMAT 
000839- C8 dae ol INY 
Seopa: 5B de °F Ree RA Four. 
00083F- FO OD 1500 BEQ .3 eee END OF FORMAT 
000841—- AA 1510 TAX 
000842- B5 00 1520 LDA 0,X 
000844- 20 DA FD 1530 JSR $FDDA 
000847= 80 FO 1540 BRA .1 
000849- 20 ED FD 1225 4 JSR $FDED 
OO0O084C= 80 EB 1560 BRA .1 
OOO84E- 60 1570 . RTS 
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Viewmaster SO 


Now run. 
AppleWorks on 
your Il+and keep 
full 80 column 
compatibility! 


as His Lee errr rr £ 


LLY 


fMewmasrerso] |. |. [.|[.J[.|. |. | 
scperers |]. | | 4 


() ne look at the chart will give vou some of the 


reasons there's only one smart choice in 80 
column cards for your Apple. But the real secret to 
Viewmaster 80's success is something even better: 

Total compatibility. 

Each Viewmaster 80 includes our powerful Apple- 
Works expand software, allowing AppleWorks to run on 
the I+ with only 64K (or more) memory. (We recom- 
mend the RamFactor memory card, but any compatible 
Apple memory card will work.) The software provides 
our full range of AppleWorks enhancements, including 
expanded records, word processor, multi-disk saving, 
time and date display on screen with any PRO-DOS 
clock, and more! 

The Viewmaster 80 works with all 80 column 
applications, including DOS 3.3, PRO-DOS, CP/M, 
Pascal, WordStar, Format II, Applewriter II, dBase I, 
Visicalc, Multiplan, and Aundreds of others — includ- 
ing AppleWorks. 

Here are just a few of the powerful features the 
Viewmaster 80 delivers for a great price ($149): 

* 80 Characters by 24 lines * Fully compatible with all 
Apple languages and software ¢ Highest compatibility 
with existing 80 column software ¢ Very low power con- 
sumption * High speed (18 MHZ) scroll rate * Upper and 
lower case characters and true descenders, both inverse 
and normal, all on-screen editing functions are sup- 
ported ¢ User-definable cursor shape * Compatible with 
Apple II, I[+ and He ¢ Five-vear warranty 

Call today to order or for more information, 9 a.m. 
to 11 p.m. seven days, or send check or money order to 
Applied Engineering. MasterCard, VISA and C.O.D. wel- 
come. Texas residents add 5%% sales tax. Add $10.00 
outside U.S.A. 


CP’M is a registered trademark of Digital Research, Inc. 


AE Applied Engineering 
P.O. Box 798, Carrollton, TX 75006 
(214) 241-6060 
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Measurement And Control Easy! 


A/D & D/A 
A/D & D/A Features: 
@ Single PC card 
8 channels A/D 


12 BIT, 16 CHANNEL, 
PROGRAMMABLE GAIN A/D 


All new 1984 design incorporates the 


SIGNAL CONDITIONER 


Our 6 channel signal conditioner is designed for use with both our A/D converters. This 
board incorporates 8 F.E.T. op-amps, which allow almost any gain or offset. For example, 


latest in state-of-art ILC. technologies. 


Complete 12 bit A/D convener, withan 
accuracy of 0.02%! 


16 single ended ¢ hannels (single ended 
means that your signals are measured 
against the Apple’s GND.) of 8 
differential channels. Most all the 
signals you will measure are single 
ended. 

9 software programmable full scale 
ranges, any of the 16 channels can have 
any range al any time. Under program 
control, you can select any of the 
following ranges: +10 volts, t5V, 
+2.5V, +1.0V, +5O0MV, +250MV, 


8 channels D/A 

Superfast conversion time 

Very easy programming 

Many analog ranges 

Manual contains sample applications 


A/D SPECIFICATIONS 
0.3% accuracy 
On-board memory 
Fast conversion (.078 MS per channel) 
A/D process totally transparent to 
Apple (looks like memory) 
User programmable input ranges are 
0 to 10 volts, 0 to 5, -5 to +5, —2.5 
to +2.5, -5to0, -10 to 0. 


an input signal that vanes from 2.00 to 2.15 volts or a signal that varies from 0 to 50 
mV can easily be converted to 0-10V output for the A/D. 


The signal conditioners Outputs are on a high quality 16 pin gold 1.C. socket that 
matches the one on the A/D's so a simple ribbon cable connects the two. The signal 
conditioner can be powered by your Apple or from an external supply. 


FEATURES 
@ 4.5" square for standard card cage and 4 mounting holes for standard mounting The 


signal conditioner does not plug into the Appie, it can be located up to % mile away from 
the A/D. 


@ 22 pin .156 spacing edge card input connector (extra connectors are easily available i.e. 
Radio Shack). 


@ Large bread board area. 


The A/D process takes place on a continuous, 
channel sequencing basis. Data is automatic- 
ally transferred to its proper location in the 
on-board RAM. No A/D converter could be 
easier to use. 
D/A SPECIFICATIONS 

@ 0.3% accuracy 

On-board memory 

On-board output buffer amps can Provides 4, 8-Bit programmable 1/0 

drive 5 MA Ports 


+ 1O0MV, + SOMV, or +25MV. 
Very fast conversion (25 micro seconds). 


Analog input resistance greater than 
1,000,000 ohms. 


Laser-trimmed scaling resistors. 


Low power consumption through the 
use of CMOS devices. 

The user connector has +12 and -12 
volts on it so you can power your 


@ Full detailed schematic included. 
PRICE $79 


/O 32 


@ Your inputs can be anything from 
high speed logic to simple switches 


sensors. 


Only elementary programming is 
required to use the A/D. 


@ The entire system is on one standard 


D/A process is totally transparent to 
the Apple (just poke the data) 

Fast conversion (.003 MS per channel) 
User programmable output ranges are 
Oto 5 volts and O to 10 volts 


Any of the 4 ports can be pro- 
grammed as an input or an output 
port 


@ Programming is made very easy by 
powerful on-board firmware 


@ The 1/O 32 is your best choice for any 


size plug in card that fits neatly inside control application 


the Apple. 
@ System includes sample programs on 


Gisk: PRICE $319 
A few applications may include the moni- 
toring of @ flow @ temperature @ humidi- 
ty © wind speed @ wind direction @ light 
intensity @ pressure @ RPM @ soil mois- 
ture and many more. 


The D/A section contains 8 digital to analog @ Ali 1/O lines are TTL (0-5 volt) 
converters, with output buffer amplifiers and compatible 

all interface logic on a single card. On-card 
latches are provided for each of the eight 
D/A converters. No D/A converter could be 
easier to use. The on-board amplifiers are 
laser-trimmed during manufacture, thereby 
eliminating any requirement for off-set 


nulling, PRICE $199 


The 1/O manual includes many programs for inputs and outputs. 


Some applications include: 
Burglar alarm, direction sensing use with relays to turn on lights, sound buzzers, start 
motors, control tape recorders and printers, use with digital joystick. 


PRICE $89 


Please see our other tull page ad in this magazine for information on Applied Engineenny’s Timemaster Clock Card and other products for the Apple. 
Our boards are far superior to most of the consumer electronics made today. All .C.’s are in high quality soc kets with mil-spec. components used throughout P.C. boards are glass epoxy 
with gold contacts. Made in Ametica to be the best in the world. All products compatible with Apple Il and //e. 


Applied Engineering's products are fully tested with Complete documentation and available for immediate delivery. All products are guaranteed with a no hassle three year warranty. 


Send ( heck or Money Order to: 
APPLIED ENGINEERING 
P.O. Box 798 
Carrollton, TX 75006 


Texas Residents Add 5% Sales Tax 


Call (214)241-6060 
Add $10.00 If Outside U.S.A. 


9am. to 11 pm. 7 days a week 
Masterc ard, Visa & C.0.D. Welcome 
No extra charge for credit cards 


Apple Assembly Line (ISSN 0889-4302) is published monthly by S-C SOFTWARE 
CORPORATION, P.O. Box 280300, Dallas, Texas 75228. Phone (214) 324-2050. 
Subscription rate is $18 per year in the USA, sent Bulk Mail; add $3 for First 
Class postage in USA, Canada, and Mexico; add $14 postage for other countries. 
Back issues are $1.80 each (other countries inquire for postage). A 
subscription to the newsletter and the Monthly Disk containing all source code 
is $64 per year in the US, Canada and Mexico, and $87 to other countries. 


All material herein is 


copyrighted by S-C SOFTWARE CORPORATION, all rights 
reserved. 


(Apple is a registered trademark of Apple Computer, Inc.) 
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